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THE OFFICIAL 
MAGAZINE 


verybody knows the Raspberry Piis a 
coding tool. It’s inspiring a whole new 
generation of students and developers. 
But the Raspberry Pi is much more than that. 
Coding on a Raspberry Pi has purpose, and that 
purpose is to control hardware and make things 
that whizz, whirr, and do stuff. 
If you’re new to this. We’ve got an amazing 
Electronics Starter Guide (Page 18). 
If you’re already a master hacker, don’t worry: 
we have something massive for you this month... 
ATIY Projects is back with a bang, and Google 
has revealed to us its new Vision Kit (Page 6). 
Think ‘Google Clips made from cardboard’. 
Inside is a new Vision Bonnet that adds an 
rtificial intelligence chip to the Raspberry 
Pi, making the Raspberry Pi 60 times faster at 
vision processing. It also enables you to control 
electronic components with AI. 
(Remember: ‘Don’t do evil with your Raspberry 
i.) Seriously though: it’s an amazing piece of kit 
nd we can’t wait to see what you all make with it. 
I wish you all a Merry Christmas and a Hacky New 
Year. Don’t forget to share the things you build 
with us and the rest of the maker community. 
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Lucy Hattersley 
Editor - The MagPi 
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FEATURE 


PROJECTS 


ISION KIT 


Google AIY Projects team reveals do-it-yourself Pi Zero W intelligent camera 


oogle AIY Projects has Kit and Google Clips, a recently “We look at how do we get 
announced its Vision Kit, announced smart camera. these technologies in people’s 
a smart camera kit you can The Vision Kit enables makers hands in ways that are easy,” 
build using a Pi Zero W, Pi Camera, to build a similar device, but that’s says Jess Holbrook, AIY Projects 
Module, and a powerful AI board just the start. ATY Projects is all UX Research Lead. 
called the ‘Vision Bonnet’. about developing hackable AI kits “AI and machine learning are 
Keen Google fans will recognise for makers that they can integrate up on this pedestal,” he explains. 
the similarity between the Vision into their own projects. Google wants to show makers that 


Movidius MA2450 


THE VISION BONNET = = ~ TET 


the Vision Bonnet, this 


i ‘ y 3 powerful VPU chip makes 
S4 ‘ A $ : oe j the Pi Zero W 60 times 


i 3 ; : phe a faster at visi ‘ocessi 
Pi camera port rae P, ’ rat vision processing 


The Pi Camera Module is 
connected directly to the 
Vision Kit bonnet 


The Vision Bonnet has six 
GPIO breakout pins, enabling 
you to integrate the kit with 
your own hardware projects 
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AIY VISION KIT 


ORDER DEC 


The AIY Projects 
Vision Kit will 
be available for 
pre-order from 
Micro Center in 
December 2017. 
The initial run 

is going to be 
very limited. If 
you're interested, 
we advise 


you to order 
a kit as soon 


as it’s available. 
microcenter.com 


they can build pretty impressive 
stuff themselves. As with earlier 
AIY Projects, Google is interested 
to see what ideas makers come up 
with to use AI to “solve problems 
for themselves, their families, 
and their communities.” 


“We have developed a deep 
learning inference acceleration 
engine that we’re running on the 
chip,” explains Kai Yick from the 
AIY Projects team. “It’s 60 times 
faster than trying to doit ona 
Raspberry Pi 3.” 


The Vision Kit adds an 
advanced AI hardware 
board to the Raspberry Pi 


All aboard Al 

The Vision Kit adds an 
advanced AI hardware board 
to the Raspberry Pi. Developed 
by Google, it’s called the 
Vision Bonnet and sports a 
powerful Movidius MA2450 
(movidius.com/myriadx) 
vision processing chip. 

The chip acts as a “neural 
network accelerator” says Billy 
Rutledge, Director of AIY Projects 
at Google. “In the case of Vision 
Kit, we are moving forward ina 
pretty big leap and running the Al 
neural network on the accessory 
board itself.” 

This is in contrast to the earlier 
AIY Projects Voice Kit, which relied 
on Google Cloud infrastructure 
for voice recognition and natural 
language processing. 
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The projects you build will 
operate independently of a 
network connection, making fora 


more versatile piece of equipment. 


The Vision Bonnet also ensures 

the security of captured images, 
as they are all processed locally 
on the device. 


Kit form 

Once you’ve assembled the Vision 
Kit, there are a number of neural 
networks software programs you 


can run. The first neural network is 


a “person, cat, and dog detector,” 
reveals Peter Malkin, Software 
Lead at AIY Projects. It detects if a 
person, cat, or dog is in the frame. 

The second neural network is 
focused on facial emotions. It will 
detect happiness, sadness, and 
other sentiments. 


The third neural network can 
identify 1,001 common objects, 
like a cup, an orange, or a chair. 

A label displays the name, and the 
level of confidence in the neural 
network’s inference. 

In the future, the hope is that 
users will be able to modify these 
neural networks. You could take 
the cat, dog, and person model and 
modify it to look for rabbits. Then 
build a project that works witha 
rabbit hutch, for instance. 


; ) Below The Vision 
Both The MagPi and Google can t Kitisasmart 
wait to see what makers have in camera project 
used to detect 


store for the AIY Projects Vision 
Kit. Pre-orders for the Vision Kit 
will begin in December at Micro 
Center (microcenter.com). 


faces, moods, and 
objects; you can 
build it at home and 
integrate it with your 
own projects 


oe ees 
A, 


> 


December 2017 MagPi | 7 


cottish firm Curious Chip 

has unveiled Pip, “the 

playful handheld device 
you program yourself.” Pip has 
been launched on Kickstarter, with 
a modest £50,000 target — see 
kck.st/2yAEc4h. A £150 pledge 
bags you a Pip, while £200 nets you 
a Pip, camera, and maker pack. 


THE 


IHACKABLE 
HANDHELD 


Make apps, play games, hack anything 


With final-version prototypes to 
play with, Raspberry Pi co-founder 
Eben Upton has given his backing: 
“Pm super-excited about this! ’m 
really, really looking forward to 
seeing what people do [with a Pip].” 

Pip’s D-pad and buttons are 
mounted on two detachable USB 
controllers — however, Jason 
Frame, co-founder and technical 
lead for Pip, tells us, “We came 
up with the removable controller 
idea... a full two weeks before 
[a certain handheld game console 


was announced]”. Two shoulder 
buttons are housed in the 
main body. 

Pip also includes a row of eight 
RGB LEDs and a 40-pin GPIO 
ribbon cable connector either 
side of its 4-inch, 800 x 480 pixel 
touchscreen. There’s a speaker, 
microphone, accelerometer, 
and compass, as well as two 
USB ports, HDMI out, wireless, 
and an optional 5MP camera. 

Pip is powered by a Raspberry Pi 
Compute Module 3 Lite. 


Above Pip is more than a games 
console - it's a mobile makers’ lab 
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Made for making 
Pip might look like a portable 
games console, and indeed it 
comes preloaded with “a number 
of open-source remakes of popular 
games like Pac-Man and Super 
Bomberman,” according to Jason. 
However, he adds, “What we 
really want is for kids - and 
adults! — to go beyond that: make 
stuff and share it with the world. 
Games, apps, physical stuff, 
everywhere and anywhere.” Pip 
was made with making in mind. 
“All we wanted to do,” Jason 
continues, “was make a portable 
device that you could have your 


A portable device that you can have your own 
code running on in less than five minutes 


own code running on in less than 
five minutes.” 
To this end, Pip has its own 
IDE, called Curiosity. “It’s hosted 
on Pip itself,” Jason reveals, “so 
there’s nothing to install.” You 
can create software for Pip on any 
machine with a web browser. 
“Curiosity offers one ‘mode’ 
for each language supported by 
Pip: JavaScript, Python, Lua, and 
PHP+HTML5,” Jason explains. 
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“There are built in libraries for 
games coding that simplify stuff 
like drawing, collision, particle 
systems, and even shader effects.” 

You can emulate your code in 
the browser, and “it’s just one 
click” to send your code to Pip 
wirelessly. For young coders, 
there’s a visual coding app called 
Livewire. Jason confirms , “We’ve 
been iterating [Livewire] for five 
years now.” 


Unusually, Pip uses a Compute Module 3 (CM3) 
rather than a Raspberry Pi 3. But Curious Chip didn't 
know what would power Pip in the early days of 
development. “The CM3 Lite edition (with SD card 
support) was announced shortly before Pip v1 
debuted at Bett 2017 [a trade show for education 
technology] and immediately we gave it a serious 


look,” Jason tells us. 

You can see the resultant motherboard to 
the left, with the CM3 slot (which the Raspberry 
Pi Foundation borrowed from laptop SODIMM 
memory) in the centre. 

Asked whether the use of CM3 gave Pipa 
possible upgrade option, Jason responds, “Size 
was the main concern... The smaller a device is, the 
more likely you are to take it with you and the more 
to can do with it.” He adds,“Pip should have enough 
juice for our expected use-cases for a good while 
to come. Isn't a quad-core, credit-card-sized SoC 
with 1GB RAM enough for anybody?” 


Make 
apps, games, and 
other software 
with Pip's built-in 
development tool 
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THE FIRST AUTONOMOUS COMPANY’? 


Coffee for the masses 


University of Edinburgh 

project might just be the 

first fully autonomous 
business. The Pi-powered BitBarista 
accepts BitCoin payments to 
dispense coffee, pays users to 
restock supplies, and will calla 
technician should a fault occur. 

BitBarista is not some glorified 

kettle with WiFi, though. Using 
the BitCoin from coffee sales, 
BitBarista “pays people for small 
services such as filling its water 
tank and replenishing it with 


BitBarista pays people for small 
services such as filling its water tank 
and replenishing it with coffee beans 


coffee beans,” according to Dr for Design Informatics, 

Larissa Pschetz, Programme University of Edinburgh and 

Director of Product Design co-creator of BitBarista. 

and Researcher at the Centre When coffee stocks run low, 
BitBarista asks the user to select 


a restock vendor. These options 
could be ranked in price order, 
or by ethical preference. Larissa 
explains, “I was also intrigued 
by this idea of an autonomous 
coffee machine that would reduce 
intermediaries in the coffee trade, 
potentially supporting smallholder 
famers in developing countries.” 
BitBarista is currently ona 
ong-term trial throughout the 
UK, “which is revealing reactions 
to the machine’s autonomous 
features,” according to a University 
of Edinburgh spokesperson. 

So far, Larissa has seen that 


a i A 
BitBarista asks users where to restock its coffee from - some rituals such as making 
would you choose the cheapest, or the most ethical? coffee for colleagues were lost 
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The technology is advanced, 
but BitBarista is built using a standard 
De'Longhi coffee maker 
while others, such as watching 
who chose the ‘best price’ option, 
were created.” 


Raspberry Pi and coffee 
The Pi controlling BitBarista uses 
Raspbian “and different plug-ins 
to simplify tasks and connect 
things together,” Larissa reveals. 
“We also use Electrum for the 
BitCoin payments.” The code is on 
GitHub, at magpi.cc/2iVHXKI. 

BitBarista might be useful for 
other vending machines, but 
Larissa warns, “The machine still 
needs to follow the social rules of 
the context where it is placed. If 
people think it is inappropriate 
they will probably turn it off.” 
Asked whether there were 
machines where BitBarista 
technology might not ever be 
appropriate, Larissa replies, “Of 
course there is always space for 
malicious practices, but people are 
careful and good at figuring these 
things out so it wouldn’t last in the 
long term.” 
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Raspberry Pi for professional applications 
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SU QUO 


Strato Pi enhances the Raspberry Pi and the Compute 
Module with hardware features that make them 
suitable for use in professional applications where 
reliability and service continuity are key requirements. 
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Grab the latest magazine from 
the Raspberry Pi Foundation 
and get hacking! 


Introducing HackSpace magazine 


he Raspberry Pi Foundation 

has launched a new 

magazine aimed at makers, 
hackers, and tinkerers. Following 
on from the success of The MagPi - 
The Official Raspberry Pi magazine 
and its education-focused sister 
mag Hello World comes HackSpace 
magazine (hsmag.cc). 

This monthly title is all about 
hacking and making. As Features 
Editor Andrew Gregory says, 

“Grab some duct tape, fire up the 
microcontroller, ready a 3D printer, 
and hack the world around you!” 

HackSpace magazine features 
tutorials and projects covering 


a huge range of topics. Just like 
The MagPi, HackSpace magazine 
is written by the community for 
the community, so get in touch 
if you’ve got a great project you 
would like to share, or if you 
want to see more coverage of 
certain topics. 

Copies of HackSpace magazine 
will be in UK newsagents from 
23 November, and you can 
download a free PDF version. 
Subscriptions start from just £2.50 
a month if you already subscribe 
to The MagPi. 

Follow HackSpace magazine 
on Twitter @HackSpaceMag. 


MOUNT PI DEVICES 


ON A 


Neatly mount multiple Pi 
devices on a DIN rail DINrPlate 
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Neatly arrange Pi clusters on a DIN rail 


INrPlate offers a neat way 

to mount many Pi devices 

together in a small space by 
attaching them all to a 35mm DIN 
rail, the same mount that modern 
fuse boxes use. 

The first DINrPlates were 
launched toward the end of 2015 
for full-sized Raspberry Pi devices, 
but there’s a new range for Pi Zero 
and Arduino units. Kurt Baum, 
President of DINrPlate, tells us: 
“The incredible success of the Pi 
and support behind it has made it 
the de facto development system 
for other industrial applications as 


well... the DINrPlate fills the need 
to securely mount the Raspberry Pi 
in an industrial environment.” 

The unit is made of tough Nylon 
6/6 plastic, onto which you screw 
the Pi using the supplied screws. 
Unlike other DIN cases which 
enclose the Pi, DINrPlate’s “open- 
frame design keeps the Pis running 
cooler under heavy workloads,” 
according to Kurt. The tab is 
DINrPlate’s “strain relief system to 
protect the power cable from being 
accidentally unplugged.” 

The DINrPlate Zero costs £10 
from modmypi.com. 


DINrPlate 
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GET CODING 


The stories we shared 
that flew around the world 


Install Python modules in seconds with piwheels 


i Foundation Community of packages for common hardware 
Manager Ben Nuttall has and software combinations. 
released piwheels, a set of However, until Ben’s project, 
pre-compiled Python modules that there were no wheels for a Pi 
reduces the install time from tens running Raspbian. 
of minutes to a couple of seconds. Enter Ben with his epic project 
Pip is the best way to install to pre-compile all 750,000 s 
Python packages, as it grabs the wheels for the Raspberry Pi. magpi.cc/2IHZWsS 
very latest version. However, With some help from SQL expert Allo's £95 DigiOne ‘audio transport’ HAT has made a 
often these packages “have been Dave Jones (@waveform80), and few waves online, claiming that its low jitter of 0.6 ps 


and noise of 50 uV make it superior to many high-end 


Pip is the best way to install audio setups 
Python packages, as it grabs 
the very latest version 


implemented in C and require the Raspberry Pi Foundation’s 
compilation,” Ben explains. web host Mythic Beasts 
Compilation takes ages, however (mythic-beasts.com), there 
— installing the NumPy package are now over 670,000 wheels 
on a Pi 3 can take over 20 minutes. for more than 96,000 packages. 
The Python community solved NumPy now installs in seconds 
this problem a while back with using the command sudo pip3 7 
? ) . i 5 magpi.cc/2lZ11N3 
wheels’, pre-compiled versions install numpy. 


PiBorg's latest robot kit is well named. Its four 300 rpm 
motors, ThunderBorg motor controller, ‘massive’ 


Ea 105mm wheels, and chunky 3mm-thick aluminium 
casing wouldn't look out of place on a battlefield. 


O uopm v 


Missing himi and a few other packages 
Consider benehts ot adding neon optimutabon tor ARNT wheels aiancanant 

Re-attempt failed packages for higher Abts BESES 

Provide Python 2.7 wheels 

Provide bython 1.6 wheels ican 

Missing package: mysqiciient EEMITEIITI 

Consider tracking manually added wheels Se w 
Provide an asy miami ua 
Provide Python 3.5 wheels aan 

Monitor piwheels usage Sl 

Package tor bys! TE w 


magpi.cc/2lMmybw 


Developer documentation EEE) 
: Rolls-Royce has joined with Formula Pi to offer coders 


the chance to ‘Race Your Code’ Successful applicants 
Any suggestions or errors should be logged had the opportunity to race ‘autonomous, Raspberry Pi- 
on the GitHub project page: magpi.cc/2iWg1GV powered robots around a track’ from 20 Nov to 7 Dec. 


Features 
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Image credit: Phillip Burgess, learn.adafruit.com/assets/46754 


Phillip's script includes ways to disable read-only mode, 
by use of a jumper or quick button connect 


Cluster HAT handles the hardware 


new version of the 

Cluster HAT - allowing 

you connect up to four 
Raspberry Pi Zeros in a cluster 


- is on sale from ModMyPi for 


Right The new 
Cluster HAT V2 has 
an improved layout 


WagPi December 2017 


Adafruit script for ‘make and forget’ Pi builds 


f you’ve ever built a Pi for 

a kiosk, installation or 

information display, you’ ll 
find Adafruit’s read-only Pi script 
invaluable. This script disables all 
the write-to-SD-card functions, 
meaning that you can pull the 
plug without any risk of data loss 
or corruption. 
The Adafruit script forces 
Raspbian to store all its temporary 
data in memory, so no data 
stored on the SD card can be 
corrupted. This also means that 
nothing at all can be written 
to the SD card. 


£28, or for £90 with four Zeros 
and four 16GB microSD cards 
(see magpi.cc/2iWlmxK). 

We liked the V1.2 ClusterHAT 
back in The MagPi #55, and this 
new model refines the design. 
ModMyPi Director Jacob Marsh 
explains, “The V2 has an improved 


) layout and utilises an IC I/O 


expander - essentially it means 
the controller can be rebooted 
without affecting the Pi Zeros, and 
the power to each Pi Zero can be 
controlled individually.” 


Script author, and Adafruit 
Creative Engineer, Phillip Burgess 
tells us, “We’re seeing Raspberry 
Pi really take off in situations 
where a microcontroller may 
have once sufficed,” and points 
out that less technical users are 
making things with a Raspberry Pi. 
Phillip wanted the ability to simply 
cut power like one does with an 
Arduino or a consumer product. 

The script only works on 
Lite installations — “Stretch or 
Jessie should work,” Phillip tells 
us — and you can find the full 
instructions at magpi.cc/2hB7qMT. 


Above Build a cutting-edge cluster 
computer in minutes 

There are also a few new 
headerless jumpers (which look 
like solder pads). For example, 
the POS jumper on the underside 
can be cut to force the Pi Zeros 
to power up with the host Pi. 

The affordable Cluster HAT 
opens the door to anyone wanting 
to experiment with distributed 
computing techniques commonly 
used in data centres or when 
analysing big data. 
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PI-CONTROLLED ECO HOME BAGS PRESTIGIOUS U.S. PRIZE 


PI-CONTROLLED ECO HOME 
BAGS PRESTIGIOUS US PRIZE 


Swiss team wins US Department of Energy’s ‘Solar Decathlon’ 


team of engineering students has won the 

annual Solar Decathlon, which challenges 

teams to “design and build a full-size, 
solar-powered house” and is run by the US 
Department of Energy (DoE). 

The Swiss team’s NeighborHub project scored 
872.91 out of 1000, with perfect scores for the 
architecture, engineering, and energy challenges 
(and 95 points or more in four other challenges). 

This clearly met the DoE’s brief of being “the team 
that best blends design excellence and smart energy 
production with innovation, market potential, and 
energy and water efficiency.” 

The NeighborHub design uses four prefabricated 
‘core’ modules to provide a kitchen, bathroom, 
bedroom, and closets; around this is the ‘Extended 
Skin’, a semi-exterior area that resembles a glazed 
cloister. The Swiss team’s brief for the technology was 
that “actuators are able to communicate to each other 
and operate together to reach optimal performance” 
and also to enable “sharing through a learning-by- 
doing approach.” 

Swiss team engineering lead Victor Saadé tells us 
that telecommunication student and team member 
Florian Meyer “basically designed the whole house 
control system,” in partnership with Swiss team 
sponsor ThinkEE (thinkee.com). It was the flexibility 
of the Pi that appealed; the team used three Pi 3s 
in the final build: one running a database, another 
running “all the algorithms”, and a third acting 
as a router. 

You can read more about the NeighborHub 
at magpi.cc/2iWrTsg. 


The Swiss team used three 
Pi 3s, each with its own 
complicated task 
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Image credit: Swiss Living Challenge 


The Swiss team's solar- 
powered eco home won 
the annual competition 


GoPiGo 


20+ new projects for your Pi robot car. 
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pi-top 


Inspiring inventors and creators to (O RASPBERRY PI 
seek the skills of tomorrow and l 
create their future, today. OCR 


pi-top 
Colors M 
Raspberry Pi 3 optional 


AWESOME INVENTOR’S KIT INCLUDED 
20 + projects 
to explore 


Explore beyond the screen and keyboard by 
creating with the all-new pi-top modular laptop. 


The modular laptop with sliding keyboard 


E i a : i : 
@ @ fad Get started with 20+ inventions in the inventor's 
sry eusTpid MODULAR guide booklet. There are 3 inventor's journeys - 
S RAIL Smart Robot, Music Maker and Space Race. 


8HR BATTERY 
LIFE 


HINGE 


pi-topCEED 


Colors M 
Raspberry Pi 3 optional 


pi-topCEED is the plug & play modular 
desktop. It's the easiest way to use your 
Raspberry Pi. We've put what you love 
about our flagship laptop in a slimmer 


form factor. Join hundreds of code clubs 
The modular desktop 


te 


14” FULL HD MODULAR 
1080P SCREEN RAIL 


and classrooms using pi-topCEED as 
their solution to Computer Science and 
STEAM-based learning. 


Modular 
Accessories 


pi-topPROTO pi-topSPEAKE} pi-topPl 


@ www.pi-top.com © @GetPiTop @ /GetPiTop Stay up to date with our latest news by following our social media 


aeangaaaaas 


pi-top is an award-winning ecosystem designed to make 
experimenting, cading and building electronics, simple, 
affordable and fun. pi-topOS is here to guide you through 
the world of making! 


The OCR* endorsed pi-topOS (Operating system) platform 
comes pre-installed on the SD card shipped with every 
unit. pi-topOS software suite lets you - browse the web, - 
check emails, - create and edit Microsoft Office 
compatible files. Gain access to dozens of hands-on 


learning lesson plans with pi-topCODER and have fun 
learning to code with CEEDuniverse! 


CEEDuniverse 


a | 


pi-topCODER has a fully 
integrated coding environment 
letting you program hardware 
code in Python and learn lots 
of STEAM skills! Our integrated 
test framework gives you the 
ability to assess your awn 
understanding as you Learn 


CEEDuniverse 


Learn programming concepts 
through our minigames, 

for example, Learn problem 
decomposition by solving 
visual programming puzzles. 


Feature 


LECTRONICS 


STARTER GUIDE 


Hands-on with circuits, components, and physical computing 
using a Raspberry Pi computer 


NOt am 
pi ATERIALS © 


A bill of materials 
(or ‘BOM)) is 

a list of parts 
you'll need to 
reproduce a 
project. Typically 
in a Raspberry Pi 
project, this isa 
list of electronic 
components 

and software 
installations. 


s well as being the best- 
looking, sharpest, and 
most stylish computer 
around, the Raspberry Pi is the 
one with the GPIO pins. These pins 
enable your Raspberry Pi to get 
physical with the outside world. 
You can hook them up to circuits 
and attach electronic components 
like LED lights, buzzers, buttons, 
and sensors. 

There are 40 pins in total and 
no shortage of components you 
can use. This is what makes the 
Raspberry Pi such an important 
part of the computing world. 
With those pins, you can 
turn a Raspberry Pi into just 
about anything. 

This feature is for those who 
want to know how to build, hack, 
and make with computers. In this 
guide, you’ll learn how to read 
schematics, prototype circuits, 
and build basic electronic kits. 
Welcome to the wonderful world 
of electronics with Raspberry Pi. 


WHAT IS A HAT? 


WHY LEA 
BASIC ELECTRONICS? È 


Do you want to be just a user 

of gadgets? Or do you want to 
be a maker, hacker, and a fixer? 
Somebody who knows what is 
going on under the surface, who 
knows how to fix, adapt, and 
improve the world around them. 

The Raspberry Pi isn't just a 
cheap, incredibly well-made 
computer. It helps you to learn 
about how computers work. 

Of course, there are many 
elements to making. There is 
learning to code, and how to use 
maker tools like 3D printers and 


BCM2837 


N 


H1 
duct tape. But prototyping your | ES 
own circuits, and making your [Fi 
own circuit boards, and learning [G3 

[F2 
how to connect components F3 
together is a vital part of the Hie 
maker process. [B5 

j FO 


The modern world is infused 
with electronic devices, and the 
future is going to be built on 
artificially intelligent electronic 
devices. So it’s incredibly 
important to understand how 
these things work. Learning the 
basics of circuit building will help 
you navigate the future. 


Welcome to the wonderful 


Raspberry Pi 


HATs (Hardware Attached on Top) are pre-built circuit boards with 
components and parts. They are designed to connect to the 40- 
pin GPIO header on your Raspberry Pi, and are easy to set up and 
get started. HATs offer a friction-free way to use electronics, and 
some (like the Pimoroni Explorer HAT, magpi.cc/10AKy46) add 

a breadboard to your Raspberry Pi. For this feature, we’ll eschew 
HATs and focus on using pure electronics connected directly 

to the Raspberry Pi GPIO pins. 


r aw 
fi 22 
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It's common to buy kits containing a variety of 
components. The parts can be used with Raspberry Pi 
resources and other tutorial guides 


PROTOTYPING 


There are two CamJam 
Edukit electronics packs 
available from The Pi Hut 
(magpi.cc/2yV1VQY). 
The first (£5) contains 

a breadboard, LEDs, 
buttons, and buzzers. 
The second (£8) also 

has temperature and 

PIR sensors. Both come 


with jumper wires and 
downloadable worksheets 
for you to follow. 


ere is a typical Raspberry Pi and breadboard 
project. Wires from the Raspberry Pi are 

connected to circuit components. Code on the | 
Pi is used to control the circuit. 


Simon Monk is a popular Ps 
writer of electronics sa. _ 
guides (he's written 
several guides for The 

MagP)). His starter kit 
(magpi.cc/2eCg5jz, ee) 
£10/$17) has all 
manner of parts and a ae 
ten projects to create. 


The GPIO pins on a Raspberry Pi are used to get input 
from components, such as a button being pushed 

or the value from a sensor. They can also be set to 
send output, and turned on or off (set to ‘HIGH’ and 
‘LOW’) to control components. 


Jumper leads are used to connect the Raspberry Pi ji This pack from ModMyPi 
GPIO pins to components on the breadboard (and to {f E (magpi.cc/2mjJJdB, £16) 


5/8 hook up components to each other). F contains a transparent 
=N k {i breadboard (so you can 
ofa) see the connections 
a a A breadboard is used to create a prototype of a circuit. inside). It also has 

bakka Components are placed into the holes on the board, LEDs resistors, 

p and jumper leads are used to connect them to each We buttons, buzzers, 

23 other (and to the Raspberry Pi GPIO pins). M sensors, and jumper 

x wires. It's one of the 

D6 more comprehensive 

u These come in all shapes and sizes and perform a kits and comes with 

T wide variety of tasks. Common components include a complete range of 


LEDs, resistors, potentiometers, PIR sensors, 
and switches. 


YouTube videos to help you 
work with each component 
(magpi.cc/2jjoftf). 
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KIT YOULL NEED 


Handy kit you need to start learning electronics with a Raspberry Pi 


BREADBOARD 


A breadboard is a plastic slab with a 
bunch of holes in it. At first glance, 
it looks pretty unfathomable, but it 
soon becomes easy to understand. 
See our How To Use a Breadboard 
tutorial (magpi.cc/2jB52Vz). We 
use a Raspberry Pi Breadboard 
(Half Size) in our diagrams 
(magpi.cc/2q34ZEz). 


Terminal strips 


In the middle of the breadboard 
are (typically two) columns of 
holes, called terminal strips. These 


are typically arranged in rows of P . 
ower rails 
five, and each hole in a group of 


DIP support 


five is connected to the one next Down each side of the breadboard 
to it. Components placed into a are two rows of holes (running all In the centre of a breadboard, between the 
row of five holes are connected the way along the board). These are two columns of terminal strips, is a gap. This is 
to each other. So you can connect positive and negative rails and are usually the exact size to place a DIP (dual in-line 
circuit components to each other typically connected to a battery, package) chip. These IC chips can straddle the 
without having to physically wire or the power (3v3/5V) and ground central division with a row of pins falling into 
them together. (GND) pins on a Raspberry Pi. | holes on either side. 
> a ihi hoki ini Ai 
JUMPER LEADS LEDs RESISTORS 
Jumper leads are used | If you’re LEDs are delicate little 
to connect the GPIO absolutely new things. If you put too much 
pins on a Raspberry Pi — _ toelectronics © current through them, they 
to the components on on a Raspberry will pop (sometimes quite 5V 
your breadboard. Some Pi, then buya spectacularly). To limit the T 
; jumper leads have female bunch of LEDs _ current going through the +4 
mi hee ends that connect to £ and resistors | LED, you should always use a RI 
M i the GPIO pins on the | (along with your ¿| resistor in series with it. The H w 
| Fà Raspberry Pi, and male H breadboard and | resistor can be anything over | 10 
i zee . Ez = ends that connect to the -* jumper leads). These | about 500hms. ii 
P 3 MF-MSMF250/X] holes on a breadboard. enable you to set up a simple | magpi.cc/2mtKKjs Ø 
h T Typically yov’ ll need a 1 circuit that lights up an LED i A Eiry 
BAP selection of female-to- with code, like the one in 101 
ojo E ; male and male-to-male this online tutorial: Physical 
i | jumper leads. bol Computing with Python. i nd fu 
2 magpi.cc/2muhzg4 magpi.cc/2mjGMJZ A Fr 
i i 
| R3 
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READING 
RESISTORS 


9V BATTERY SNAP 


Your Raspberry Pi outputs 
a steady 3.3V from some 
of its GPIO pins and it’s 


perfectly possible to get by PUSH BUTTON Use the colour bars on a resistor to read its values. 
without a battery. Butwe 0 UU One of the ends will have a stripe on it, typically silver 
find a 9V battery with a snap A push button is a great way to or gold. Make sure that is on the right. Now look 
cable a handy way to add test out input on a Raspberry closely at the bands in the middle, 
power to a circuit and test Pi (where you create code that The first two bands represent numbers and the 
—— outcomponents. responds to physical button third is a multiplier. In the resistor below, we have two 
| magpi.cc/2mshkSG pushes). Some push buttons orange (3) bands and a brown (10) multiplier. So our 
have two pins; others — like resistor is 3310, or 330 ohms). The final gold band 
this one — have four pins and shows that it has a tolerance, or precision, for the 
Q3 are designed to fit across the resistor. Ours is 5%. 
EER ba DIP support bridge at the 
Aq T centre of a breadboard. Band 1: | Band 2: Band 3: | Band 4: | 
Fy, magpi.cc/2mqTgj2 Number Number Multiplier | Tolerance 
À CE: o BROWN: | 
ry ane = —47" 1% | 
| PIR SENSOR | 
ll” ae BROWN: : RED: | 
A PIR (passive infrared) sensor | || 1 2% | 
—  isused to detect motion. E | 
Alongside buttons, they are RED: i ; GOLD: 
| j | a good way to add input to a 2 5% 
| | 49 project. You can create a script 
10 that detects movement and PIEZOELECTRIC ORANGE: ORANGE: ORANGE: SILVER: 
as respondsaccordingly, | 9 ~~---------------- 3 3 1000 10% 
magpi.cc/2msRLkJ SPEAKER 


ees ese= Sse YELLOW: YELLOW: YELLOW: NOTHING: 
This buzzer is used to add 4 10000 20% 


basic sound to a project. While 

it’s not going to rock the GREEN: GREEN: 
house, a piezoelectric speaker 5 100000 
is a handy way to get feedback 

from a project. BLUE: BLUE: 
magpi.cc/2muqIFy 6 1000000 


VIOLET: GOLD: 
7 0.1 

The ultrasonic distance sensor can determine how GREY: SILVER: 

far it is from a solid object. It works by sending out 0.01 

a burst of ultrasound. 

This sound will travel 

. through air but 

5 reflect back (echo) 

off hard surfaces. The 

sensor detects the 

echo. They’re often 

05 ‘ found on robots and 

other Raspberry 

Pi projects. 

magpi.cc/2mtgpS1 


+ 
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WIRING 
AND 


nce you’ve got a breadboard There are two approaches to and similar ones used by the 
and some electronic describing the layout of electrical Raspberry Pi Foundation and other 
components, you’ll want to circuits. The first is to use a wiring resources. If you’re interested 
start wiring them up and learning diagram (see ‘Wiring diagram’). in creating your own, you use a 
how they work with a Raspberry Pi. The simple circuit shown below program called Fritzing to make 
There’s absolutely no shortage connects a push button and them (fritzing.org). 
of electronic projects out there, LED to separate GPIO pins ona If you want a guide to GPIO 
and most of them guide you Raspberry Pi. The Raspberry Pi pins and acrash course in 
through attaching components detects a button push and lights controlling them with GPIO Zero, 
to your breadboard, then using up the LED. take a look at our Beginner’s 
software such as the GPIO Zero You’ ll find wiring diagrams Guide to GPIO Zero in The MagPi 
Ses Python library. like this throughout The MagPi, issue 52 (magpi.cc/Issue-52). 
| |-+- 
1 Í, | WB 
h + : Er 
I Seal a Jumper leads are Follow the lines of holes on 
represented by these the breadboard to see how 
coloured wires e components are connected e 
i i 
i] I 
a O rimai ia 
[j 
ULL à éo “emer ee 08 5 AF 
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Components 


The components are visually similar to real- 


V V life counterparts. Some, like the LED, visually 
M e 


demonstrate which way around they should go 
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SCHEMATIC DIAGRAM 


The GPIO pins of a Raspberry 


Raspberry Pi 1777 Pi are represented by this 


ive 4 large rectangle. They are 

l 

: not in the same positions 
as the physical pins on the 


e 
GPIO2 SDA1 12C GPio21 
GPIO3 SCL1 12C GPIO20 real board 
GPIO4 GPIO16 


GPIO17 GPIO12 


GPIO27 Components are 


D 
GPIO22 GPIO7 SPIO_CE1_N 
Red (633nm) 
GIPO10 SPIO_MOSI GPIO8 SPIO_CEO_N 


represented by abstract 
symbols, like this triangle 
with arrows (which 


GPIO9 SPIO_MISO GPIO25 


GPIO11 SPIO_SCLK GPIO24 represents an LED) 
ID_SD 12C ID EEPROM GPIO23 
GPIOS GPIO18 PCM_CLK 
ee See ene. -E Black lines are used to 


GPIO13 GPIO14 UARTO_TXD indicate connections 


GROS between components on the 


GPIO26 . . 
circuit. These can represent 

jumper wires or components 

connected to the same rail 


on a breadboard 


1V8 
UTIN 
BCM28% 


HOW TO: UNDERSTAND -| __ 
SCHEMATIC DIAGRAMS © = a 


LIR | 
>STEP-01 » 
Components R 1 
Schematics describe how components are connected. 

Unlike wiring diagrams, symbols aren’t visually +5 % 
similar to.their real-world components and the KK, 330Q 
schematic isn’t necessarily visually accurate. It’s a 
guide to how things are connected. 

Take the resistor. Instead of being a visually realistic 
tube with coloured rings, it is indicated by these zigzag 


XTALF 


AGND= 13 
AGND_14 


W18 


lines (we’re using the US-style resistor symbol in this D 1 3 
feature, in the UK it’s often a square rectangle). The 
properties are often listed alongside as text. Learning Red (633nm) 


to identify components is half the battle. Take a look 

at the ‘Component reference guide’ (page 25), which 

compares symbols with their real-world counterparts. > STE P-02 
Connections 


R 1 Now we’ve added a second component to our resistor, 
an LED. This is represented by a triangle (the symbol 
+5 % for a diode, it indicates that flow can only travel in 
= one direction). The LED symbol also has two arrows 
3 30 Q pointing outwards, representing light being emitted. 


We join the two components together with a single 

l 2 black line. This indicates that they are connected (on 
our prototype breadboard they could be in the same 
row of holes, or connected with a jumper lead). 
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RI 
+5% 
WA 33082 
K NW 
DI 
Red (633nm) 


D NC2 
D PAD HH 
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H 
EH 


12305UX 


Hy 


k 


D1 
Red (633nm) 


>STEP-03 

Integrated circuits 

Our Raspberry Pi is displayed as an IC (integrated 
circuit) box. This large rectangle has pins all around 
it representing the pins on the GPIO header. We’ve 
connected our resistor and LED to GPIO 17 (as written 
inside the IC box). Like other components, the IC 
schematic is an abstraction and doesn’t resemble 
the physical layout of the pins. Use a pin guide 
(pinout.xyz) to locate the physical pins on your 
Raspberry Pi board 


>STEP-04 

Wires and nodes 

Sometimes, wires form a junction that connects 
multiple components together. Our button is ona 
separate GPIO pin to the LED and resistor, but both 
join together and connect to a single ground pin. 
Wires connecting at a junction are indicated by large 
circles called ‘nodes’. When you see this circle, it 
means wires in the circuit connect at this point. 
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33002 


2D1 
>STEP-05 


Crossed wires 

In a well-designed schematic, parts will be kept 
separate and wires will not cross each other. This isn’t 
always possible with more complex schematics, and 
sometimes designs just aren’t as clear as they could 
be. If you see two wires crossing each other without a 
node circle, that means the wires are just passing by 
(and aren’t connected). 


D1 
Red (633nm) 


>STEP-06 

Reference designator 

Now that you know how to identify wires and 
components on the schematic, you simply need 

to identify each component and the order they are 
connected in. Component names are normally a 
letter and a number. So your first resistor is R1, the 
second one R2, and so on. You can view a list of all 
the common reference designators on Wikipedia 
(magpi.cc/2mqvyUf). Happy prototyping. 
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Here are some common 
components along with their 
reference designator letter and 

RE F E R E | \ | a E G | ID E both visual wiring graphic and 
schematic diagram. 


Reference Wiring Schematic 
Component | designator image symbol 


E 12 Y eN2 
Er | 
8- 
pg eN 
Anode | J Cathode 


Resistor 


Capacitor 


Diode (LED) E 
Q 


Switch 


Transistor 


$ 


Schematic symbols courtesy of Wikipeda.org 
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GPIO MUSIC BOX 


This project shows you how to wire up buttons to your Raspberry Pi’s GPIO 


pins and then use them to play sounds with a simple Python application 


n this tutorial, we’ll use several push 
buttons to make a GPIO music box that 
triggers different sounds when we press 
different buttons. 

For this, we’ll make use of GPIO Zero’s Button 
class to assign sound samples to buttons. While we 
have provided a wiring diagram, we suggest you try 
following the schematic first, using your new-found 
knowledge. If this proves troublesome, check the 
schematic against the wiring diagram. 


>STEP-01 

Get some sounds 

Before we start building our GPIO music box circuit, 
we’ll need to prepare some sound samples for it to 
play. First, open a Terminal window and create a 
directory called musicbox for this project. Then create 
a directory called samples within musicbox. 

We need to source some sound samples. While there 
are many public domain sounds to be found online, 
for this example we’ll use some of Scratch’s built-in 
percussion sounds, already present on the Pi. Copy the 
Scratch percussion sounds to the samples directory. 


EED 


Raspberry Pi 
Breadboard 


4 x Tactile 
switches to 
make buttons 


5 x Male-to- 
female jumper 
leads 


4 x Male-to-male 
jumper leads 


mkdir musicbox 

mkdir musicbox/samples 

cp /usr/share/scratch/Media/Sounds/ 
Percussion/* /home/pi/musicbox/samples 


>STEP-02 

Add a button 

Now follow the schematic and wire up the first button. 
Place the button so it straddles the central groove of 


3V3 
Jg Remember, the switches are not wired to each 
== other. This junction points out that both are 
ma e i connected to a single ground pin 
Jlag BCM28397 | 
i+ E = The GPIO pin positions on the schematic diagram 
OO don't match those on the physical board. Use 
3 a pinout.xyz if you need guidance on the pin position 
Stapi HES 


GPIO15 


ONAA 
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WIRING DIAGRAM 


Try to wire up the circuit using the schematic 
below. If you find it difficult to follow, check this 
diagram. More instructions are on the Raspberry 
Pi resources website (magpi.cc/2z44wrC) 


GPIO MUSIC BOX SCHEMATIC 


Raspberry Pi 3 
Model B v1.2 
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Each time you press a button, the assigned sound sample will 
play through a connected speaker 


Extra buttons can easily be added to the circuit to play more 
sounds assigned in the Python code 
the breadboard. One leg is connected to the GPIO 2 
pin, and the other to the common ground rail on the 
breadboard, which in turn is wired toa GND pin. 


>STEP-03 Mi, Saatini 


Now add a second button to the circuit, again 
following the schematic. Place it on the breadboard 
as before, and wire it up to GPIO 3 and the common 
ground rail. 

Now open a new file in Python 3 IDLE, enter 
the code from gpio_musicbox.py, and save it in 
your musicbox folder. Run the program and push 
the buttons. You should hear a noise with each 
button push. 


>STEP-04 


PLL-VDD 
XOSC_VDD 


DOWNLOAD: 


pygame.mixer 


3 mi magpi.cc/2BaGLLM 
The way we have structured the program makes it Een oe aie ee 
easy to add extra buttons and assign them to sound signal RUBE 


samples. Just connect each button to a GPIO number 
pin (not any other type) and the ground rail, as before. 
Then add the GPIO pin numbers and sounds to the 
dictionary, as in the following example: 


pygame.mixer.init() 


button_sounds = { 


Button(2): Sound( ve 
sound_pins = { : Button(3): Sound( J5 
2: Sound("samples/DrumBizz.wav"), es D a )s 
3: Sound("samples/CymbalCrash.wav") , > } patna e ages cl Ak )s 
4: Sound("samples/Gong.wav"), 
14: Sound("samples/HandClap.wav"), button, sound button_sounds.items(): 


button.when_pressed = sound.play 


Add more buttons and redraw the schematic with 
switches connected to the Raspberry Pi IC. 


pause() 


a 
we 
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RANGE-FINDER 


Link together an ultrasonic distance sensor and seven-segment display 


to measure distances 


ee 
NE 
a= 


HC-SRo4 
ultrasonic 
distance sensor 
magpi.cc/ 
2mtgpS1 


Broadcom 5082- 
7650 7-segment 
display 
magpi.cc/ 
1YnqQPl 


9 x Resistors 

(7 x 220Q, 

1 x 512 Q,1 x 1kQ) 
magpi.cc/ 
1YnqUir 


he HC-SRo4 ultrasonic distance sensor is a 
great favourite with Pi robot-makers. It works 
by bouncing ultrasonic sound off an object and 
timing how long it takes for the echo to return. This 
time is then converted into a distance which can be 
displayed on a single-digit, seven-segment display. 
Here you can acquire the skills to handle inputs and 
outputs. You also get to use seven-segment displays, 
which are quite cool in a retro kind of way. 


>STEP-01 

Lighting the display 

The seven-segment display is a collection of LEDs, 
with one LED corresponding to one of the segments. 
All the anodes (positive ends) are connected together, 
this should be connected to the 3.3 V power (3V3 pin). 
The cathodes (negative ends) should be connected to a 
resistor to limit the LED current and the other end of 
the resistor to a GPIO pin. To turn the LED on, all you 
have to do is set the GPIO output to be LOW (oV) and it 
will complete the circuit for the current to flow. 


The HC-SR04 ultrasonic distance sensor 
is displayed as an IC with four pins 


7 Segment CAI 
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You can use any seven-segment display, but 
alternatives might have a different pinout 


Ultrasonic distance sensor: gives out a pulse 
proportional to any reflecting object in front of it 


>STEP-02 

Generating a seven-segment pattern 

The display consists of four bars or segments that can 
be lit. By choosing the segments to light up, you can 
display a number from 0 to 15, although you have to 
resort to letters (also known as hexadecimal numbers) 
for this. There are, in fact, 128 different patterns you 
can make, but most are meaningless. In our code 
(range_finder.py), a list called seg defines which pins 
are connected to which segments, and another list 
called segmentPattern defines the LED pattern for 
each number. 


Remember that two points crossing are not 
linked unless there's a large circular node. 

On this schematic, the lines are coloured 
differently to help guide the ‘ratsnest’ of wires 
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The project in action; the Pi is measuring how far it is 
to the Raspberry Pi 3 box 


>STEP-03 


The display function sets up the segments to 
display any single-digit number passed to it. First, 
it sets all the segments to off, and then if the 
number is less than 16, it goes through the entries 
in the segmentPattern list for that number and 
turns on the appropriate segments. Note that we 
can still use on and off even though they’ re not 
powered by individual GPIO pins, as the LEDs were 
declared to GPIO Zero as active_high = False. 


>STEP-04 


The HC-SRo4 distance sensor signals its reading 
by producing an output pulse that the Pi tries to 
measure. The GPIO Zero library measures this 
pulse and converts it into a distance by returning a 
floating-point number that maxes out at 1 metre. 
We then multiply this number by 10 to give 
decimetres. Next, we convert it to an integer to get 
rid of the fractional part of the measurement, so we 
can show it on our single-digit display. 


>STEP-05 


For this build, we used a dinky little breadboard 
shield from Dtronixs. This allowed for a much 
more compact arrangement than a conventional 
breadboard, although you can of course still use 
one. As the HC-SRo4 uses a 5V power supply, the 
pulse we have to measure is also nominally 5V. 
Therefore, this has to be cut down to 3.3 V by using 
a512 Q and 1KQ resistor voltage divider. 
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STARTER GUIDE 


display 
02. gpiozero LED 
03. gpiozero DistanceSensor 
| 84. time 
wW 25. 
ma 06. seg = [LED(27, False),LED(25, 
S False),LED(24, False), 
07. LED(23, False), LED(22, 
) False),LED(18, False), 
o8. LED(17, False)] 


a2, 3,6], [1,2,5, 6] 


5,6], #0 to 5 


14. sensor = DistanceSensor(15,4) 


16. def main() : 


f 17. print( ) 


f 19. 1: 
9 20. distance = sensor.distance 


decimeters 
print( , distance) 
distance 10.0: 
distance 16.0 


display(int (distance) ) 
time.sleep(@.8) 


def display( 8 
i range(@,7): 
seg[i].off() 
number 16: 


seg[segmentPattern[ number] [i] ].on() 


# Main program logic: 
__name__ 


DOWNLOAD: 
magpi.cc/2BaGLLM 


# displays the distance in decimetres on a 7-segment 


10 # distance in 


i range(@, len(segmentPattern[number])): 


10. segmentPattern agile sa? Sile [Liles @ptheGass Sill (sal 
[ 


3 

ality, [9 5,6], [0,1,2], [0,1,2,3,4,5,6] 
nlos 1S2 576p LONS 2 6], #6 to A 

12 [2,3,4,5,6],[0,3,4,5],[1,2,3,4,6],[@, 
3h ANS), TO ASren BECO NE 


The distance to the reflective object is updated every $ 
0.8 seconds. If this is greater than a metre, then the 


display will be blank. A display of 0 indicates that the tod on i 
object is less than 10cm away. Don’t touch the sensor, 1903 e KE | 
otherwise its readings will be wrong. Also, as it has | 
quite a wide beam, you can get reflections from the | 
side. If several objects are in the field of view, then the 
distance to the closest one is returned. 

a i 
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CLOTHING 


Mart Drake-Knight and his brother Rob have put dozens of Raspberry Pis 
at the heart of their super-efficient clothing factory 


> Rapanui's 
factory plugs 
into the Internet 
of Things 


> All workstations 
and machinery 
are Pi-powered 


> The UI has 
been made 
mistake-proof 


> IBM's Node- 
RED is free and 
open source 


hen brothers Rob and Mart 

Drake-Knight struggled 

like mad to find a job in 
2008, they could so easily have 
reached a point where they would 
have to sell the shirts off their 
backs. Luckily they decided to spend 
£200 setting up an environmental 
clothing company on the Isle of 
Wight instead, growing it from a 
garden shed to a large factory in a 
former Co-op supermarket. 


Today, the whole operation at 
Rapanui is powered by renewable 
energy and a creative, hackathon, 


> Fire destroyed 
the previous 
factory in 2016 


DIY spirit. More specifically, it also 
makes use of nearly 100 Raspberry 
Pis to perform many different 
tasks. “Some are connected to 
sensors or machinery that we’ve 
made in our machine shop,” says 
Mart. “Some do simple stuff like 
open windows and help people 
solve problems.” 

Other Pis drive touchscreens 
and workstations and they 
enable staff to prioritise work. 
Put together, they have made 
Rapanui’s manufacturing process 
very efficient while allowing the 


firm’s eco-friendly and sustainable 
clothing to be affordable. By 
automating the dull parts of the 
job and giving managers a solid 
overview of what’s happening in 
the factory and where, Rapanui 

can go as far as offering tailored 
services: you could get the 
company to make a single T-shirt 
with your picture or logo or order 
1,000. Either way, you could have 
the garment the following day. 

n order to bring the technology in 
the factory together, Rapanui uses a 
lightweight messaging protocol for 


This Arduino robotic 
arm is an experiment 
to see if tasks can be 
delegated to it 


An Echo Dot is also 
connected so workers 
can verbally ask the 
robot to perform tasks 


Connected to a Pi 
receiving MQTT 
data, it listens to the 
instructions given to 
Pam and attempts to 
parallel-perform the 
same task 
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small sensors and mobile devices 
called MOTT and this allows the Pis 
to broadcast their behaviour to other 
machines or human interfaces. 
Using Node-RED, the hardware 
devices, APIs and online services are 
wired together. 

“We use Node-RED in live 
production to broadcast order data 
between two specific machines that 
are time-critical,” Mart tells us. 
“More recently we used Node-RED 
for cool stuff like joining an Alexa 
API to our factory systems so that 
you can ask the factory questions 
such as how many jobs are pending, 
which lets us direct staff to the 
areas where they are needed. It also 
controls some robotic equipment 
we’re working on.” 


Creating tech jobs 

The firm has since built on that 
system to produce Teemill.com, 
which lets users create an online 
store, sell T-shirts, and take the 
profits of each sale. “People can 
join and access the API directly via 
Teemill,” Mart says. But just as 
importantly, Rapanui’s approach 
to the development of its clothes 
has created desirable tech jobs 
on the Isle of Wight, with the 
company able to show its young 


Creating an order 

A customer can create any product 
they like at Teemill.com. When a 
T-shirt is ordered, Holly picks the order. 
The Pi runs the interfaces, which are 
connected via Node-RED/MQTT. 
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employees how to code though 
programming apprenticeships. 

“The Pi has given us a great way 
to build confidence at the early 


stage in people who want to start 
a career with us in computing,” 
continues Mart. Indeed, today 
the company invests a lot of its 
time developing automated, real- 


The whole operation is powered 
by renewable energy anda 
creative, hackathon, DIY spirit 


with us.” 


>STEP-02 

Printing the T-shirt 

The lights change colour, alerting workers 
to the location of the next task. The 
workstation interfaces broadcast the 
machine's status to the MQTT broker, 
which is run centrally on a Pi. 


Raranu ==- 


time production systems which Running 
; Rapanui's factory 
allows products to be made in the erate 
seconds after they are ordered. business, hence 
« F the mass of 
The breakthrough has massively pivowered 


screens at this 
computer terminal 


reduced waste and cost,” Mart tells 
us. “And since we’ve doubled in 
size every year and the Raspberry 
Pis are modular, they have scaled 


Sending it out 

When the T-shirt is ready, Pam scans 
and packs it. The interface tracks her 
work, broadcasting the status back to 
the systems. The customer is notified 
that the order is on its way. 
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> The project 
requires lots 
of drilling and 
woodwork 


> The camera's 
housing is 
made in two 
connecting 
parts 


» It uses OpenCV 
-acomputer 
vision software 
library 


> The camera's 
object 
detection is 
better at lower 
angles 


> Aaron and 
Davis list 
their other 
projects at 
hackerhouse. 
site 


Davis is picked up on camera 
thanks to OpenCV's object- 
recognition capability 


SECURITY 
CAMERA 


Be a Pi spy with Aaron Tainter and Davis Lau’s amazing camera 
that makes use of the open-source computer vision library OpenCV 


here are plenty of home 

security cameras currently 

on the market, many 
allowing you to stream live footage 
over the internet and receive alerts 
whenever someone wanders past. 
But rather than buy one of those, 
two makers, Aaron Tainter and 
Davis Lau, spied an opportunity. 
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Combining a Raspberry Pi Zero W, 
a Pi Camera Module, and the 
amazing OpenCV app, they decided 
to make their own. 

The inspiration to do so felt 
obvious. “We’re known for mixing 
artificial intelligence and computer 
vision with our DIY projects, so 
a smart security system seemed 


Inside the housing is a Pi Zero W 
and a Pi Camera Module. A hole 
is cut for the power cord 


to align well with our genre,” 
explains Aaron. The pair have 
previously created numerous 
home-automation projects, ranging 
from an indoor gardener to a 
smartphone-connected door lock. “I 
think our security camera resonates 
with people. The object-recognition 
part is really fascinating.” 


The camera is mounted using 
a 90-degree angle bracket 
fixed to the wall with outdoor 
mounting tape 
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OpenCV (opencv.org) makes 
adding computer vision to Pi 
projects rather straightforward. 

It allows you to train the Raspberry 
Pi to identify objects and react to 
them, which is perfect given that 
Aaron and Davis wanted their smart 
security camera to feature facial 
and body detection. The plan was 
for the camera to send an email 
notification whenever it detects 
someone, although it can be set 

up to stream live video through a 
webcam server too. 

“We also wanted to add a servo- 
gimbal so that you could tilt and 


Above One drawback is that the camera 
can only recognise one object at a time 
Fortunately, writing the code for 
the web app proved easier and they 
were thankful OpenCV exists and 
could (after a staggering eight hours) 
be installed on the Pi Zero. “Without 
OpenCV, the project wouldn’t have 
been possible,” Aaron explains. 
“Tt contains thousands of lines of 
code that were written over the 
course of many years and it gives 
individual developers like us the 
chance to produce something 
awesome without years of research 
and development.” 


I think our security camera 
resonates with people 


pan the camera from the web 

app,” says Aaron. “But because we 
typically give ourselves a month 

to complete a project like this and 
have to film and edit the build 
videos for our YouTube channel, 

by the time we finished building the 
camera body we didn’t have enough 
time left for it.” 


Smart housing 

That seems a shame, but then 
building the camera’s MDF housing 
was a tricky process, with various 
holes needed in the right places 

to gain access to the Pi. “We also 
wanted to make the top removable 
so that the components were more 
accessible but compact enough that 
it could be mounted on a ceiling,” 
says Aaron, explaining that a CAD 
model was built first so that they 
could get the measurements just 
right when they cut the materials. 
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The pair still needed to tinker 
with it. “We had to make a few 
optimisations to get the camera 
working at a high frame rate because 
OpenCV eats up the CPU,” Aaron 
recalls. There was also an issue with 
the video feed being choppy, solved 
by parallelising a few processes 
in the code. But before long, the 
camera was allowing the viewing of 
live streams, detecting objects and 
sending any images it picked up on 
to a Gmail address. 

“The Raspberry Pi Zero is a 
great piece of hardware because it 
has a small form factor yet comes 
loaded with features,” says Aaron 
of the reason why it works so well 
in the camera. “It was the perfect 
platform to mount in a small case 
and run our image-recognition 
software. Pm surprised how much 
performance you can get out of that 
tiny computer.” 


>STEP-01 

Build the housing 

After designing the housing and creating paper 
templates for guidance, a %4-inch (6mm) MDF board 
is cut to size. The pieces are then glued and screwed 
together before being sprayed black. 


>STEP-02 

Insert the bits 

The Pi Zero W and Pi Camera Module connect via an 
Adafruit Pi Zero Camera Cable. Future versions may 
contain a NolR Pi Camera: “It's supposed to have 
exceptional low-light capabilities.” 


PP ae 


>STEP-03 

Sending it out 

An MbientLab micro-USB to USB cable powers the 
device and OpenCV software is used. “I'd like to try 
different ‘image classifiers’ to recognise other objects 
like cats and dogs,” Aaron says. 
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The manipulator arm tip can also 
be equipped with a hook to pick up 
blocks with Loops attached 


NASA 


With the ability to draw any shape, this robot arm is out of this world 


E] a — - = = 


hand reaches out to a shiny S E < = 
gold box emblazoned with The six-axis robotic arm is an 
the NASA logo. At the 7 upgrade from the previous 


witican draw an versions’ four-axis manipulator 
y press of a button, the connected 


shape using x-y : x : z 
coordinates robotic arm springs into life, 
lowering a blue Sharpie pen onto 


> Dan took i 
around a year a paper pad to draw the circular 
to refine the outline of the famous logo, 
software then an inner ‘spacecraft orbit’ 

> The arm ellipse, before switching to a red 
cana sope pen to sketch the red chevron 
controlled f 
manually (magpi.cc/2zHatl!7). 

f This is the Advanced Robotic 

> It's powered by $ 
an original Pi 1 Manipulator System Tools and 
Model B Resources — or ‘ARM?’ for short 

> APCAQ685 - built and programmed by Dan 
board drives Gribok, a robotics intern at NASA’s 


the arm's 
servos 


Goddard Space Flight Center within 
the Satellite Servicing Projects 
Division. Designed to be used at 
outreach events to educate the 
public in what NASA is doing with 
robots, the Pi-powered ARM is a 
versatile device that can also be 
controlled manually using an Xbox 
gamepad to pick up objects using a 
hook or grabber. 


Art for events Components inside the 
. : control box include an 

Dan tells us that the drawing original Pi 1 Model B 

ability came about from a need 

to have a constantly running 

demonstration at events, such Each pen is held loosely ina 
saint Dea fi C : tube, so the drawing pressure 

as this year’s Awesome Con in is provided by gravity 

Washington DC. “So we wanted 

a demo where you could just push 
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a button, step back, and everyone 
could watch all at once. And you 
can also give away a sheet of paper 
at the end and have them say, 
‘Hey, a robot drew this — how cool 
is that?” 

Asked about what ARM can draw, 
Dan says it depends on what he 
can program into it and what the 
hardware can actually replicate. 
He admits that the drawing action 
is a little jerky, which is due to 
the hardware itself: “There’s a 
ot of slop in the joints, a couple 


The force of gravity is used to 
get the pen pressure right, as each 
Sharpie pen is held loosely ina 
tube. “We previously tried some 
other spring-like mechanisms, but 
we just settled on gravity drawing 
because it’s so much easier and it 
works perfectly fine.” 

So, what’s in the shiny control 
box? Somewhat surprisingly, along 
with a PCA9685 PC servo controller 
and other components, the ARM 
uses an original Raspberry Pi1 
Model B - as did the two previous 


We wanted a demo where you 
could just push a button, step 
back, and everyone could watch 


of degrees, and some slop in the 
other mechanisms, which makes 
it really hard to draw [smooth] 
curved lines.” However, since 

it understands positions and 
coordinates, “Any line that you 
can express as x and y coordinates, 
so virtually anything, you can 
program into it and itť’ll just follow 
that over and over.” 


versions of the project, which 
were based on OWI Edge robot 
manipulators. In autumn 2016, 
Dan was granted permission to 
upgrade the project’s robots: 
“T kept about half the internals of 
the control box and got completely 
new robot manipulators.” 

While the hardware setup was 
relatively straightforward, the 


software took a lot longer. “The 
original robots were programmed 
in Python, but I noticed that we 
had performance issues, so we 
switched entirely to C++.” After 
getting basic robotic functionality 
working by spring 2017, Dan 
made improvements over the 
summer, including adding the 
drawing capability. 
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Pressing 
the button 
causes the arm 
to start drawing a 
preprogrammed 
sketch, in this case 
the NASA logo 
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DASHBOARD OUT RUN 


Quic! Combining two classics into one amazing racing project, Matt Brailsford 


Facts 


ay back in 1983, a Japanese 


> The fuel gauge company called Tomy 


> The turbo light 


represents created one of the most 
the stage time $ ; 
remaining remarkable toys of its generation: 
Tomy Turnin’ Turbo Dashboard 
eames onin was a driving simulator complete 
high gear with gears, ignition, a working 


> A small dashboard, a steering wheel, and 


vibrating motor even a looping display. 


wasiaddeg Three years later, Sega released 
for haptic 


feedback arguably (well, we’d argue it) the 


> Matt tried | Z 


four different 
screens before 
finding one 
that fit 


This classic Tomy Turnin’ 
Dashboard is hacked into 
a Sega arcade machine 


> Matt hacked 


the speed to 
change it to 
mph from kph 


December 2017 


greatest, coolest racing game 
of all time: Out Run. 

One maker, Matt Brailsford, 
picked up a Tomy Turnin’ Turbo 
Dashboard on eBay and had a spark 
of genius: why not turn it into a fully 
working Out Run arcade machine? 

Matt removed the original 
display from the Tomy Turnin’ 
Turbo Dashboard and replaced 


used a Raspberry Pi to build this incredible ’80s mash-up of racing toys 


it with a modern screen. “I tried 
quite a few [screens] trying to get 
one that would fit,” says Matt. His 
first attempt was a screen that 
worked from the GPIO, but this left 
few pins for all the other mods. 
“And the extra processing slowed 
the game down.” 

In the end, Matt used a KeDei 
3.5-inch HDMI display (kedei.net). 


The screen displays an Out 
Run clone called Cannonball 


All of the controls and dashboard 


components are wired up to the 
Out Run game via a Raspberry Pi 
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TOMY TURNIN’ TURBO DASHBOARD OUT RUN 


Projects 


= HACKING 


A TOMY TURNIN’ 


P 


Alot of components are carefully squeezed inside the original plastic case 


The original ignition key from 
the game was already wired as 
an SPST switch, so Matt wired 

it up to the Raspberry Pi. To 
manage the safe powering up 
and down, he used a PowerBlock 
(magpi.cc/2mLOf4P). “I simply 
hooked up the switch and installed 
the daemon to watch for the 
shutdown command and it all 
worked perfectly. A Picade PCB 
(magpi.cc/29DpDCz) was used to 


time and thinking things through, 
then trying things out.” 


Cannonball running 

You might be expecting the 
Raspberry Pi inside to be running 
an emulator like RetroPie, but 

no. It’s actually running an Out 
Run clone called Cannonball 
(magpi.cc/2mL3bAi). Matt 
explains: “Cannonball is a C++ 
port of the original Out Run arcade 


Ultimately it was just taking 
my time and thinking things 
through, then trying things out 


hook up the rest of the controls. 
Mike tells us it was “really easy to 
hook these up”, especially because 
the Picade PCB supports analogue 
controls for the steering wheel. 


Turn the key 

“There was a lot of luck involved 
as well,” explains Matt. “Lucky 
that the slide potentiometer 
happened to sit at the perfect 
height, lucky that there was 

just enough room for some 
microswitches to fit down the 
side of the gear shifter, and lucky 
I could balance the shifter rubber 


bands to keep the shifter centred... 


Ultimately it was just taking my 
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game and luckily ran perfectly on 
a Raspberry Pi 3. The reason I went 
with this rather than, for example, 
MAME is that it allowed me to 
change the core code and intercept 
the variables I wanted to use to 
update the dashboard. You could 
probably achieve something similar 
in MAME by inspecting the register 
values, but having access to the raw 
source code is way easier.” 

Matt tells us it’s fun to play. 
“Tt was a little squeaky to start with, 
but I had just tightened everything 
up a little too much. It runs nicely 
and brings back those memories 
as a kid. It’s how I thought it felt to 
play with back then.” 
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Tutorial 


Turn your web camera or Pi Camera Module into a stunning kaleidoscope 


> Webcam or 
Raspberry Pi 
Camera Module 


> Camera mount 
(optional) 


kaleidoscope is an age-old toy normally 

found in your Christmas stocking at least 

once in your life. Basically, it’s two mirrors 
set at an angle in a tube pointing at a collection of 
highly coloured blocks. By using a webcam, we can 
manipulate what it sees into a fascinating moving 
kaleidoscopic display on your Raspberry Pi. You can do 
this in real time at a good frame rate using a Pi 3 and 
a standard webcam; or, for a better-quality result, use 
the high-resolution Pi Camera Module. Figure 1 shows 
a Christmas-themed kaleidoscope image. 


Here's the live 


kaleidoscope image 


from the camera 


In this example we're 
using the Raspberry Pi 
Camera Module 


er 
S ope RN 


— 


Optional camera support 
allows you to point the 
camera where you want 


The principle 
An eight-fold symmetry image can be created by a 
collection of simple horizontal and vertical flipping 
of segments of the image. These are fast for the 
computer to perform as they simply involve shifting 
bytes from one area of memory to another. Figures 2A 
and 2B (overleaf) show the steps we have to take in 
order to create this effect. First, the original image 
is duplicated and the duplicate is flipped vertically, 
producing an image with the same width but twice 
as high as the original. Then a triangular area is 
removed from each corner; this is done by filling the 
shape with a colour and making that colour the colour 
key, causing it to be transparent. This produces the 
basic quarter segment, which is duplicated three 
times - applying a horizontal flip and two rotations. 
Finally, these segments are all drawn together on the 
screen. They need to be shuffled a bit to fit snugly and 
eliminate lines on the joins. 
The image going into this process can itself be 
flipped or rotated to change the final pattern. Figure 3 
(overleaf) shows the results of doing this. 


Original image Copy and flip 


© 
e L, 


Mask off half 


To produce a 
quarter segment 


Figure 2A Creating the symmetrical image (see also Figure 2B) 


The software 

We used the Pygame framework and the 

pygame . camera extension. The Pygame 
documentation warns that this interface might 
change, or indeed be removed in future versions. This 
will work with a compatible USB webcam — to check 
before you buy one, see magpi.cc/2yOgQsK. In order 
to make the Pi’s Camera Module compatible with this 
system, we need to enable the camera drivers in the 
menu Preferences > Raspberry Pi Configuration and 
reboot. Now you should type in the Kaleido_Cam.py 
program. There is a line in the software that makes 
sure the V4L2 drivers have been enabled as well. If you 
are typing in the program, note that in the line: 


os.system("sudo modprobe bcm2835-v412") 


... the end number should be lower-case V - four - 
lower-case L ~- two. 

The software makes use of what Pygame calls 
‘surfaces’. A surface is simply an area of memory that 
can hold a bitmap image. Surfaces are transferred to 
other surfaces by the use of the ‘blit’ operation, whose 
name harks back to the old days of computer graphics. 
The showScreen function is where all the heavy work 
takes place. First, it sees if the input image needs to 
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faleido- Cam.py 


002. 
003. 


004. 
005. 


006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 


014 


015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 
035. 
036. 
037. 
038. 
039. 


040. 
041. 
042. 
043. 
044. 


045. 
046. 


047. 
048. 
049. 
050. 


KALEIDO CAM 


>PYTHON 3 
import pygame, pygame.camera, os 


from tkinter import Tk 
from tkinter.filedialog import 
asksaveasfilename 


DOWNLOAD: 
magpi.cc/1NqJjmV 


PROJECT 
VIDEOS 


os.system("sudo modprobe bcm2835- 
v412") # needed for Pi camera 
Tk() .withdraw() 

pygame. init() 
pygame.camera.init() 

os.environ[ 'SDL_VIDEO_WINDOW_POS'] = ‘center’ 
pygame.display.set_caption("Kaleido Cam") 
pygame.event.set_allowed(None) 
pygame.event.set_allowed([pygame.KEYDOWN, pygame .QUIT]) 


Check out Mike's 
Bakery videos at: 
magpi.cc/1aNqJnTz 


cs = 320 # basic image size 
cs2 = cs * 2 # window size 
screen = pygame.display.set_mode([cs2,cs2],0,32) 


find, open and start camera 

cam_list = pygame.camera.list_cameras() 

print (pygame.camera.list_cameras()) 

webcam = pygame.camera.Camera(cam_list[@], (640,480) ) 
webcam. start() 

preRot = @ ; autoRotate = False 

savePath = "" 3; shotNumber = ð ; saveSource = False 
flipH = False ; flipV = False 


def main(): 
while True: 
checkForEvent() 
showScreen() 


def showScreen(): #grab image, scale and blit to screen 
global camFrame, preRot 
camFrame = webcam.get_image() 
if autoRotate : 
preRot += 0.5 
if preRot > 360: 
preRot -= 360 


rotFrame = pygame.transform.scale(camFrame, (cs2,cs2)) 


make square 
rotFrame = rot_center(rotFrame,preRot) # rotate 
sqFrame = pygame.Surface((cs,cs)) 
sqFrame.blit(rotFrame, (0,0), (cs//2,cs//2,cs,cs)) 
else : 


sqFrame = pygame.transform.scale(camFrame, (cs,cs)) 


make square 

if flipV or flipH: flip origional image option 

sqFrame = pygame.transform.flip(sqFrame, 

flipH,flipV) 
# prepare master segment 
primary = pygame.Surface((cs,cs2)) 
primary.blit(sqFrame, (0,9)) 
primary.set_colorkey((@, 255, @)) 
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056. 
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096. 
097. 
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primary2 = pygame.transform.flip(primary, 
False, True) 
primary2.blit(sqFrame, (0,2)) 
primary2.set_colorkey((@, 255, Q)) 
# mask out part of image 
pygame.draw.polygon(primary2, (090,255,0), 
((8, cs), (cs,8), (0,0)),9) 
pygame.draw.polygon(primary2, (909,255,0), 
((8, cs), (cs,cs2), (0,cs2)),0) 
# draw master segment in various positions 
screen. fill((0, ð, @)) 
screen.blit(primary2,(cs-1,0)) 
primary = pygame.transform.flip(primary2,True, 
False) 
screen.blit(primary,(1,-1)) 
primary3 = pygame.transform.rotate(primary2, 90.0) 
screen.blit(primary3, (@,1)) 
primary3 = pygame.transform.rotate(primary2, 
-90.0) 
screen. blit(primary3, (@,cs-1)) 


pygame.display.update() # display screen 


def rot_center(image, angle): 
# rotate an image while keeping its center and 
size 
orig rect = image.get_rect() 
rot_image = pygame.transform.rotate(image, angle) 
rot_rect = orig _rect.copy() 
rot_rect.center = rot_image.get_rect().center 
rot_image = rot_image.subsurface(rot_rect) .copy() 
return rot_image 


def saveScreen(): 
global shotNumber, savePath 
if savePath == "" :; 
savePath = asksaveasfilename() 
shotNumber = @ 
print("save path", savePath) 
rect = pygame.Rect(1,1,cs2-2,cs2-2) # remove black 
lines 
sub = screen. subsurface(rect) 
pygame. image.save(sub, 
savePath+" “+str(shotNumber)+". jpg") 
if saveSource: 
rect = pygame.Rect(0,0,640,480) 
sub = camFrame.subsurface(rect) 
pygame.image.save(sub, 
savePath+" “+str(shotNumber)+" source. jpg") 
print('saved as", savePath+" “+str(shotNumber)+" . 
jpg") 
shotNumber +=1 


def terminate(): # close down the program 
webcam. stop() 
pygame.quit() # close pygame 
os._exit(1) 
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Generate four copies of segment 
each rotated by 90 degrees 


Figure 2B 


be flipped or rotated and then creates the symmetrical 
image we have described previously. The auto-rotation 
function might need a little explanation, however. 
When this is enabled, the rotation angle increments 
half a degree each frame. In order for the rotation to 
eventually produce an image of the correct dimensions 
as all the previous operations, we take a square image 
twice the size, rotate it around its centre, and then select 
a square portion of it at the correct size. This means 

the resulting image is a bit zoomed in, to avoid blank 
sections at various rotation angles. The effect, however, 
is as if you were turning the kaleidoscope tube. 


Using the software 

The startup condition has no preprocessing on the 
input image. You can simply wave the camera around 
and see the results in real time. The RETURN key will 
save the kaleidoscope; the first time, it will prompt 
you for a folder and an initial name. Subsequent 
images will be saved using that name with number 
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Original image 


Figure 3 Input image manipulations 


Flip Horizontal 


"HNA Tutorial 


Flip Vertical 


Rotate 45° Rotate 65° 


A pte 


postfix, which increments with each frame. Pressing 
the S key will allow you to change the folder and root 
name, as well as resetting the postfix number. The O 
key will toggle the option of saving the original image 
along with the kaleidoscope image. The keys H and V 
will apply horizontal and vertical flipping of the input 
image, and the R key will start off the auto-rotation of 
the input image. 

We found that the best results were obtained 
when you could not imagine what the input image 
was and it looked rather abstract. In fact, the most 
plain boring input images often produced better 
results than detail-packed ones. The quality of the 
auto-rotated images was slightly degraded due to the 
rotation process producing jagged edges on diagonal 
lines. One thing you will notice immediately is that 
if someone is in the input image, the results can look 
quite ghoulish. 


Taking it further 

We used either a simple LEGO mount for the camera, 
or nothing at all. However, we can’t help but think 

a pan-and-tilt mount moving slowly might produce 
results that look good. There is scope for generating 
other degrees of symmetry using rotation instead of 
flipping - see what you can produce. 

Unfortunately, we did not find a way for the image 
effects of the Raspberry Pi Camera Module to be 
enabled when it is running into Pygame - maybe 
some programming wizard could. Mind you, they 
are all quite simple image-processing algorithms, 
so you could apply them by using software in the 
pre-symmetry image manipulations. 
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def checkForEvent(): # see if we need to quit 

global savePath,autoRotate, 
saveSource,preRot,flipH,flipV 

event = pygame.event.poll() 

if event.type == pygame.QUIT : 

terminate() 
if event.type == pygame.KEYDOWN : 
if event.key == pygame.K_ESCAPE : 


terminate() 

if event.key == pygame.K_s : 
savePath = "" 
saveScreen() 

if event.key == pygame.K_RETURN : 
saveScreen() 

if event.key == pygame.K_r : 
autoRotate = not autoRotate 


print("Auto rotate =",autoRotate) 
if autoRotate: 
preRot = 0 
if event.key == pygame.K_o : 
saveSource = not saveSource 


print("Save the source file =",saveSource) 


if event.key == pygame.K_h : 

flipH = not flipH 

print("Flip horizontal now =",f1lipH) 
if event.key == pygame.K_v : 

flipV = not flipV 

print("Flip vertical now =",flipV) 


# Main program logic: 
if _name_ == ' 
main() 


__main_': 
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Raspberry Pi 3 


C-STEMbian 
magpi.cc/ 
2p3JUNP 


Breadboard 
Jumper wires 
1x LED 


1 x 220Q resistor 
(Red-Red-Brown) 


TROUBLE- 
SHOOTING 
HELP 


Remember 

to use 
GPlOviewer 
for testing the 
pins before 
programming. 
If this fails, 
check the LED 
is plugged in 
properly and 
the wires for all 
components 
are in the 
correct spots. 


To better 
understand the 
layout of the board, 
click on the Board 
Layout tab 


Change the mode 
of a specific pin 
by selecting input, 
output, or PWM 


The name of each 
pin can be found 
in the centre of 
GPlOviewer 


USE A GUI TO 
CONTROL GPIO PINS 


Discover a simple way to interact with GPIO pins using C-STEM 


ne of the easiest ways to get started ona 

Raspberry Pi is with C-STEM Studio on the 

C-STEMbian operating system. It removes 
many of the hassles associated with programming in 
C by using C/C++ interpreter Ch. Ch is superset of C 
with many high-level extensions. It can run C code 
without compilation. This article will demonstrate how 
to get started controlling GPIO pins on the Pi using 
GPIOviewer and WiringPi with a project in Ch and 
highlight some key features of the system. 

To make use of these programming tools, you 
should install the C-STEMbian operating system 
(magpi.cc/2p3JUNP) which contains C-STEM Studio. 
This free, open-source operating system contains 
all the necessary tools for robotics and physical 
computing. Additionally, it is a superset of Raspbian, 
so all the familiar features will still be there. If you 
already have Raspbian installed, the C-STEM modules 
can be installed separately on top. Step-by-step 
guides will assist you in setting up and accessing the 
Raspberry Pi if needed. 


GPlOviewer = x 
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While this article will focus on ChIDE, GPIOviewer, 
and the WiringPi package, there are many additional 
features included in C-STEMbian: 


> C-STEM Studio (magpi.cc/2xEGEag), a platform for 
hands-on integrated learning of computing, science, 
technology, engineering, and mathematics (C-STEM). 


> Ch Mindstorms Controller for controlling multiple 
LEGO MINDSTORMS (EV3 or NXT) from the Raspberry 
Pi using a simple user interface 


> Linkbot Labs which, like the MINDSTORMS 
equivalent, gives a user interface for total control 
of one or more Linkbots. 


> Ch Arduino for controlling and programming in Ch 
an Arduino Uno's pins from the Raspberry Pi. 


Make a circuit 

The program in this tutorial would be useless without 
a circuit to test it on. If you have one, use a breakout 
board to make the wiring process clearer. Otherwise, 
wire the pins directly from the Pi. Take a wire from 
the GPIO 4 pin and connect it to an empty row of the 
breadboard. Then, attach the positive lead of an LED 
to this row. From the negative lead of the LED, attach 
a 220 Q (Red-Red-Brown) resistor to ground. 

Before programming, we can use GPIOviewer, a 
helpful feature of the C-STEMbian operating system. 
To use it, navigate to the big ‘C’ on the top of the 
desktop window. 

Once open, navigate to ‘Ch Raspberry Pi’ and click 
Launch in the bottom right-hand corner. This will 
open up GPIOviewer, which allows total control of all 
GPIO pins of the Raspberry Pi. In this view, you can 
change pin modes between input, output, and PWM 
(with a slider). For this circuit, find GPIO pin 4 on 
GPIOviewer and set it to output. 

Ensure the circuit is set up and working properly by 
switching between high and low outputs. If the light 
turns on, you are ready to program. 
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Example blink code in C 

The classic way of programming this circuit on the 
Raspberry Pi would resemble the C code in blink.c, 
which includes the wiringPi library. This code also 
works in Ch interpretively without compilation. 


qanquage 


/* File: blink.c */ 
#include <wiringPi.h> 


int main() { 
wiringPiSetupGpio() ; 
pinMode(4, OUTPUT) ; 


NAME: 
blink.c 


DOWNLOAD: 


while(1) { magpi.cc/BlinkPi 
digitalWrite(4, HIGH); 
delay(5@@) ; 
digitalWrite(4, LOW); 
delay(5@@) ; 
} 
return @ ; 


The code uses GPIO pin numbering and sets pin 4 
to an output. Then, it enters a while loop that cycles 
the LED every half second between on and off. 
Notice the standard int main function that requires 
a‘return @ statement. 


Equivalent Code in Ch 
However, to run the code just in Ch, the program can 
be simplified to the code in blink2.ch. 


qanquage 
>Ch 


/* File: blink2.ch */ 
#include <wiringPi.h> 


wiringPiSetupGpio() ; 
pinMode(4, OUTPUT) ; 
while(1) { 
digitalWrite(4, HIGH); 
delay(5@0) ; 
digitalWrite(4, LOW); 
delay(5@0) ; 


NAME: 
blink2.ch 


DOWNLOAD: 
magpi.cc/BlinkPi 


} 


USE A GUI TO CONTROL GPIO PINS 


Notice that the int main function is gone. Just like 
Python and other scripting languages, there is no need 
to create any functions for a simple program. This is 
just one of the many benefits of using Ch. While this 
method of programming is most common for users 
coming from C programming, there is another way. 


Scripting in Ch 

Besides writing code resembling C, it is possible to 
write scripting code in Ch. The same program as 
before is rewritten in blink3.ch. 


#!/bin/ch anguage 
/* File: blink3.ch*/ 1g 
>Ch 
gpio -g mode 4 out 
while(1) { NAME 
f f wena blink3.ch 
BET e reeves DOWNLOAD: 
delay(5@@) ; magpi.cc/BlinkPi 
gpio -g write 4 @ 
delay(500); 
} 


Ch provides both methods as an option so that you 
can choose whichever is more comfortable for your 
style. To run the Ch code, it is easiest to use ChIDE. 
To launch it, click the magnifying glass icon next 
to the big ‘C’ you clicked to open C-STEM Studio. 
Alternatively, navigate to ‘Programming with Ch’ 
within C-STEM Studio’s menu. Type the code into the 
code editing pane. To run it, click the Run button at 
the top of the interface above the code. If all goes well, 
the LED should blink on and off indefinitely. 


DAMA S KTOXK me AQAR & mom x 
= $ e J s A 4 


v 
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7* File: blink2.ch */ 
#include <wiringPi.h> 


wiringPiSetupGpio(); 
pinliode(4, OUTPUT): 


while(1) { 
digitalwWrite(4, HIGH); 


digitalWrite({4, LOW); 
deloy(500); 
} 


, debugr 


Above ChIDE provides easy-to-use debugging tools to step 
through Ch code 
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Debugging 

Another useful feature of Ch is the ChIDE debugging 
feature. Like any popular IDE, the ChIDE provides easy 
to use debugging tools to step through Ch code. To 
step through the code, use the debug control panel at 
the top of the window. You can step into functions or 
through code with the Step and Next buttons, and you 
are able to set break points by clicking in the grey line 
number column between the numbers and text. For 
example, set a break point by clicking in the grey area 
to the right of line 9. Then, click the Continue button. 
Every time you click this button, it will run the program 
until it hits another breakpoint. Since this is a while 
loop, it will hit this break point every time. 


Above Set the 
circuit up as shown 
in the diagram, 
with a breakout 
board or with 
wiring directly 
from the Pi 


FOR HELP 
AND NEW 
IDEAS 


Open the 
‘Learn Physical 
Computing 
with Raspberry 
Pi’ textbook 

in the Ch 
Raspberry 

Pi section of 
C-STEM Studio 
for more 
circuits and 
programs. 
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Tutorial STEP BY STEP 


MAKE A 


> 3D-printed star 
magpi.cc/ 
2i2tbkU 


> 3 x RGB LEDs 


> 3 x 150Q resistors 
> 6 x 100Q resistors 
> 220Q resistor 

> Push button 

> Wire 


> Breadboard 
(optional) 


|. VV 


Create the perfect tree topper with 
this 3D-printed, Pi-powered star, 
over which you have full control 


very year here at The MagPi, our Features 
Editor Rob Zwetsloot says he’s going to make a 
new star for his Christmas tree that’s powered 
by a Raspberry Pi. This year he’s finally decided to put 
his money (or text) where his mouth is and make one. 
As Christmas is all about sharing, we thought 
he should also show you how to make one. After 
all, there’s nothing merrier than a Raspberry Pi 
Christmas. So get out your cinnamon-spiced soldering 
iron and put a Santa hat on your 3D printer and let’s 
create some festive joy. 


i 


all |; 
= 
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ROB ZWETSLOOT 


Tinkerer, sometime maker, other- 
times cosplayer, and all-the-time 
Features Editor of The MagPi. 
magpi.cc 


Select a star 

The most important part of this project is the star. 
We’ve used one from Thingiverse (magpi.cc/2i2tbkU), 
which you can see in the pictures for this tutorial. 
However, you can use whatever star shape you want. 
All you need to do is make sure it’s hollow and you can 
easily access the inside of the star, but the electronics 
for the star will work the same in any case. 

You can look for different star shapes on 
Thingiverse (thingiverse.com), or even draft up 

your own in 3D modelling software like Blender. 


Get printing 
Not everyone has a 3D printer at home, however much 
we would all love Santa to bring us one. If you’re not 
lucky enough to have access to one at your workplace, 
your local makerspace might have one. 

If all these options are unavailable to you, then we 
highly recommend checking out 3dhubs.com. It’s 
a fantastic service that aggregates thousands of 3D 
printing services — all you need to do is set your location 
and upload your files and it will find a 3D printer. These 
might be a local business or a bigger company - either 
way, you can find out price estimates and what type of 
printer services each company provides. 

You don’t need to get very expensive material for 
the star, although we do recommend translucent 
plastic. Ours is orange, but you can likely find yellow 
if you prefer. 


Use this Fritzing diagram as a guide for wiring up the 
LEDs and button 
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>STEP-03 

Solder it up 

While waiting for your star parts to be delivered, now 

is a good time to build your circuit. It’s quite simple: 

each RGB LED colour pin is hooked up to its own GPIO 

pin, the ground pins go to ground (GND), and then 

the button gets its own pin. Check out Figure 1 for 

a wiring guide. 

The button and each colour pin of the RGB LEDs 

require a resistor for them to work, so don’t ignore 

them when testing or soldering up your circuit! 
Figure out where you want to put the Pi relative 

to your tree and cut the wires for the distance 

accordingly. Alternatively, try hiding a Pi Zero 

in the star! 


>STEP-04 
Add the code 
We have some example code you can try out, called 
star_lights.py. Make sure Raspbian is installed on the 
Pi you plan to use and write it up/download it to the 
home folder. Run the code to test out the circuit and 
make sure everything works ~ it should start with all 
the LEDs lighting up white, then each button press 
will change it: blinking, then pulsing, then all on 
with different colours, then blinking or pulsing with 
different colours. 

In the Terminal, use sudo nano /etc/profile and 
add the following line to the bottom so that the code 
runs at startup: 


sudo python star_lights.py 


>STEP-05 

Construct the star 

Once the star has arrived, use some sticky tape 

to carefully stick the LEDs to the star. We stuck 
ours to the rear half of our two-part star and then 
glued the bits together. Give it another test to see 
if you’re happy with it. Modify the code as you see 
fit (see the GPIO Zero RGBLED doc for reference: 
magpi.cc/2i3MTgq) and turn off ‘boot to desktop’ 
in the Pi configuration to save some power. 


>STEP-06 

The tree-topping ceremony 

Now is the big moment. Decorate the rest of your tree, 
get your favourite Christmas jumper out, and put the 
kettle on. If you have a tall tree, get a ladder out - 
safety first, after all - and place your star over the top 
part of the tree. 

There. Christmas has begun. We recommend 
pairing your ceremony with a nice cup of tea 

(which is why we told you to put the kettle on) 

and a mince pie. From all of us at The MagPi, we 
wish you a Merry Christmas, Happy Holidays, and 

a Happy New Year! 
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star _lighis.p y >PYTHON 


from gpiozero import RGBLED, Button 


from time import sleep DOWNLOAD: 
magpi.cc/ 

ledi = RGBLED(14,15,18) magpistar 

led2 = RGBLED(23, 24,25) 

led3 = RGBLED(8,7,12) 


button = Button(21) 


mode1 
mode2 


(1, @, @) # Red 
(@, 1, @) Green 


while True: 
led1.on() 
led2.on() 
led3.on() 


button.wait_for_press() 
button.wait_for_release() 


led1.blink() 
sleep(@.4) 
led2.blink() 
sleep(@.4) 
led3.blink() 


button.wait_for_press() 
button.wait_for_release() 


led1.pulse() 
sleep(@.4) 
led2.pulse() 
sleep(@.4) 
led3.pulse() 


button.wait_for_press() 
button.wait_for_release() 


led1.on() 
led2.color(mode1) 
led3.color(mode2) 


button.wait_for_press() 
button.wait_for_release() 


led1.blink(on_color=(mode1), off_color=(mode2) ) 
sleep(@.4) 
led2.blink(on_color=(mode2), off_color=(mode1) ) 
sleep(@.4) 
led3.blink(on_color=(mode1), off_color=(mode2) ) 


button.wait_for_press() 
button.wait_for_release() 


led1.pulse(on_color=(mode1), off_color=(mode2) ) 
sleep(@.4) 
led2.pulse(on_color=(mode2), off_color=(mode1) ) 
sleep(@.4) 
led3.pulse(on_color=(mode1), off_color=(mode2) ) 
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DIY INDOOR 
AIR-QUALITY 
MONITOR 


Build your own indoor air-quality monitor using the Raspberry Pi Zero 


n this tutorial, you will learn to build yourown Connect the sensor 


indoor air-quality monitor/data logger. We The CCS811 sensor comes with an [°C interface and 
will build it using the Raspberry Pi Zero and requires a 3.3 V power source. The clock and data pins 
Raspberry.Pi the CCS811 volatile organic compound sensor. of the sensor needs to be connected to the pins GPIO 3 


Zero 


The collected data would be used to provide a visual and GPIO 2 respectively (shown in Figure 1). 


Fimoroni Biinkt: indication of the air quality (using an RGB LED strip) 


LED strip 

i and the information collected would be saved to a Test the sensor 
Ae Google Sheets spreadsheet. The visual aid serves to The first step is to enable the PC interface and verify 
Mini Kit educate people about their immediate surroundings that the sensor is interfaced correctly and check 
Sparkfun CCS811 while the data saved to a spreadsheet helps whether the Raspberry Pi is able to detect the sensor 
sensor understand the air-quality trends in a room. on the PC interface. 


Stackable 2x20 
female headers 


The CCS811 VOC sensor is 
interfaced to the Raspberry Pi 
Zero via the I?C interface 


4 x Male-to-male 
jumper cables 


3D-printed 
enclosure 
(source files 
available with 
this tutorial) 


The data collected from the 
sensor is logged to a Google 
Sheets spreadsheet using 
IFTTT (if-this-then-that) 


VOC_Data Ba 
File Că View inset [Format Data Tools 


Add-ons Helg 


na? 100% $ & 0 00 92 


August 6, 2017 at 09.46"M 


a e 


October 1, 2017 at 03:23AM 408 
2017 at 03:38AM 435 
2017 at 03:53AM 455 
2017 at 04:08AM 438 
2 2017 at 04:23AM 443 
12% October 1, 2017 at 04:38AM 424 
1734 October 1, 2017 at 04:53AM 428 
1290 October 1, 2017 at 05:08AM 424 J ; The Pimoroni Blinkt! is used 
1257 October 1, 2017 at 05:23AM 424 J aa to provide a visual indication 
1258 October 1, 2017 at 05:38AM 430 s i t of the air quality in the 


1259 October 1, 2017 at 05:50AM 463 ‘ immediate surroundings 
© October 1, 2017 at 06.06AM 435 i 
1391 October 1, 2017 at 06:23AM 435 
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DIY INDOOR AIR-QUALITY MONITOR 


The CCS811 sensor 
is connected to 3V3 and GND, 
and its clock and data pins to 
GPIO 3 and 2 respectively 


s.e... 
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e.e... 
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The PC interface can be enabled from the Raspberry 
Pi’s desktop. Go to Menu> Preferences > Raspberry Pi 
Configuration. Under the Interfaces tab, enable the 
‘12C interface. 

Now, open the Terminal and enter: 


sudo i2cdetect -y 1 


The above command should list all the devices 
connected to the Raspberry Pi’s PC interface. As 
shown in Figure 2, the CCS811 sensor’s address is 
ox5A. According to the sensor’s data sheet, the sensor 
could be configured to the address ox5A or Ox5B. 

The next step is setting the clock rate of the PC 
interface. We need to adjust the PC interface clock 
speed to meet the sensor’s clock rate specification. 
Edit /boot/config.txt from the Terminal: 


sudo nano /boot/config.txt 
Add the following line to the end of the file: 
dtparam=i2c_baudrate=8000 


Save the changes to the file (CTRL+X) and reboot 
your Raspberry Pi. 


Above The observed volatile organic compound trend over a 
24-hour period. This information can be useful in identifying 
ventilation needs for a room 
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Install the prerequisite libraries 
In order to read data from the sensor, we need to 
install some dependent libraries: 


pip install python-periphery requests 
configparser 
sudo apt-get install python-blinkt 


We installed the python-periphery library to access 
the PC interface and the Python requests library to 
upload the sensor data to a Google Sheets spreadsheet. 
We installed the blinkt library by Pimoroni to control 
the RGB LED strip. If you are using a different RGB LED, 
install the prerequisite library for the same (if any). 

Note: At the time of building this gadget, there were 
no libraries readily available to read data from the 
CCS811 sensor; therefore, we wrote our own library. 
Adafruit Industries has since published its own library 
(pypkg.com/pypi/adafruit-ccs811). Choose a library 
that meets your needs. 


Tutorial 


INSTALLATION 


Install the 
gadget in your 
living room to 
understand 
whether the air 
quality in your 
home needs 
improvement. 


Figure 2 

Listing all devices 
connected to the 
Pi's ?C interface 


EP pi@raspberrypi: ~ 
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Tutorial WALKTHROUGH 


Your key is: 


tpa / maker MUL comm kd 


Figure 3 Take a 
note of the key 
and store it in the 
key.ini file 


VISUAL AID 


Use a Sharpie 
or permanent 
marker to 
demonstrate 
the effect of 
volatile organic 
compounds. 
Do not use the 
VOC sensor 

to measure 
carbon 
dioxide levels. 


Figure 4 The 
enclosure can be 
3D-printed using 
the STL files in the 
project repository 


Read data from the sensor 

Before we put everything together, we need to test 
every component of our gadget. Let’s get started with 
testing the sensor. In order to verify that the sensor 
operates as expected, we need to perform a simple 
transaction using the PC interface. According to 

the data sheet, it is possible to read the value at the 
register, 0x20, and retrieve the hardware ID of the 
sensor. In this case, it is 129 (hex: 0x81). 

The code for this gadget can be downloaded from 
the GitHub repository (magpi.cc/2zrzuXP). From 
the Terminal, switch to the directory containing the 
code. Launch the Python interpreter and execute 
the following: 


>>> import ccs811 

>>> my_ccs811 = ccs811.CCS811(device_ 
address=@x5A) 

>>> print(my_ccs811.read_byte(@x2@) ) 

129 


Now that we have the verified the sensor function, 
let’s test the RGB LED strip. 


Testing the RGB LED strip 
We used the Pimoroni Blinkt! LED strip 
(magpi.cc/2yg5Mng) for this tutorial. Pimoroni 
provides the library required to control the RGB 
LED strip and hence it is very easy to integrate into 
the project. 

The library installation is a one-stop process 
(shown in the prerequisite installation step). 
Let’s write a quick Python script to test the library: 
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import blinkt 
from time import sleep 


while True: 
blinkt.set_al1(255, © , @) 
blinkt.show() 
sleep(1) 
blinkt.set_al1(@, 255, 0) 
blinkt.show() 
sleep(1) 


The LED strip should alternate between red and 
green colours with a one-second interval. 


Setting up your IFTTT account 

We will be using IFTTT (if this, then that) to save the 
sensor data to a spreadsheet. If you are not familiar 
with IFTTT, we recommend reading this tutorial from 
The MagPi (magpi.cc/2yicro8) - note that the Maker 
Channel is now called the Webhooks service. 

To save the data to a spreadsheet, we create an IFTTT 
applet where a webhook containing the sensor data is 
used as a trigger to add a row to the spreadsheet. 

Record your webhook key from the webhook 
documentation page: Your Profile > Services > 
Webhooks > Documentation (Figure 3). 

Save your key in a file called key.ini (or any file 
name of your choice) in the following format: 


[CREDENTIALS] 
key = YOUR_KEY 


Replace the text YOUR_KEY with your IFTTT 
key. Now, let’s test if we are able to add a row 
to a spreadsheet. 


config = configparser.ConfigParser() 
config. read('/home/pi/key.ini' ) 
key = config.get('CREDENTIALS', 'key') 
payload = {'valuei': 1, 'value2': 2} 
print(URL. format (key=key) ) 
try: 
response = requests.post(URL. 
format (key=key), json=payload) 
except requests.exceptions. 
ConnectionError as error: 
print(str(error) ) 
if response.status_code == 200: 
print("Success") 


If the sensor data was successfully posted, you 
should be able to verify that a row has been added to 
the spreadsheet. 


Soldering/assembly 

Now that we have verified the components, let’s 
solder the sensor onto a prototyping board. We 
recommend using the Adafruit Perma Proto Bonnet 
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Mini Kit (magpi.cc/2yg7o0xk), since it comes with the 
same profile as the Raspberry Pi Zero. Instead of using 
the headers that come with the kit, we recommend 
using the stackable headers (magpi.cc/2yidoag). This 
would enable stacking the Pimoroni Blinkt! LED strip 
on top of the Proto Bonnet Mini Kit. 


Enclosure 

In order to produce an orb-like effect, we used an 
enclosure that diffuses light. We designed an enclosure 
that could be built using a 3D printer (Figure 4). We 
recommend using a white filament, as it best diffuses 
the light. The enclosure consists of a top portion that 
diffuses the light and a bottom portion that holds 

the Raspberry Pi Zero. The enclosure design files are 
available in the project repository (magpi.cc/2zrzuXP). 


Putting everything together 

Once you have assembled the Raspberry Pi Zero, 
CCS811 sensor, and LED strip into the enclosure, it is 
time to test the gadget. The code consists of a CCS811 
class that handles all interactions with the sensor, i.e. 
reads/writes data to the sensor. 

When the script is run, the sensor is reset and 
initialised. Upon initialisation, we poll the status 
register to determine if new data samples are available. 
According to the data sheet, the DATA_READY flag 
indicates whether a new sample is available. 

When a new sample from the sensor is available, the 
program fetches the equivalent carbon dioxide levels 
and the volatile organic compound levels (VOC). We 
use the VOC levels to set the colour of the RGB strip. 
For example, if the VOC levels are below 16 ppb, we set 
the colour to green; if they are greater than 60 ppb, the 
RGB strip is set to red. The FadeInOut method is used 
to produce a light effect by adjusting the brightness 
levels of the LED strip. Every 15 minutes, a data point 
is uploaded to the Google spreadsheet using the 
post_data method. If the ERROR flag of the STATUS 
register is set, the program automatically resets the 
sensor and re-initialises the communications. 

Run the Python script and the gadget should start 
glowing green. Open a permanent marker or any pen 
that has an odour and introduce it into the enclosure. 
You will notice that the enclosure changes colour from 
green to red. 


NOTE: The CCS811 sensor requires a 48-hour burn-in 
and at least 20 minutes after power-up to provide 
stable readings. 


VOC trends from spreadsheet 

Let the gadget run for at least 24 hours and collect 
data in 15-minute intervals. It would be interesting 
to look at the trends and find out if your room needs 
modifications to its ventilation. 
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The sensor started 
glowing red whena 
Sharpie was brought 
close to the enclosure 
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>PYTHON 


NAME: 
ccs811.py 


DOWNLOAD: 


magpi.cc/2zrzuXP 


BEN (BENSTR) STRAHAN 


Benstr leads Developer Relations at 
hologram.io. His job is to make cool 
projects, connecting ‘things’ to the 
world with cellular. 
hackster.io/benstr / @_benstr 


CONNECT YOUR 
WITH CELLULAR 


_—  —— 


Connect your Pi to the 
mobile network and use 
a phone to chat to it 


> Hologram 
Developer SIM 
hologram.io/ 
devplan 


> Hologram Nova Ask the Pi some 
hologram.io/ sample questions 
nova via SMS messages 


> Hologram 
Python SDK 
magpi.cc/ 
2zfB6Co 


You can easily add extra set 
responses to the code or 
modify it to use local Al 
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Going places without WiFi? Ben Strahan shows how to use mobile 
networks and send SMS messages to your Pi 


ver wonder what your Raspberry Pi was 

thinking? This tutorial shows how you can ask 

your Pi questions no matter where it is in the 
world. Learn how to send questions through SMS to 
your Raspberry Pi and get witty answers back. 

You’ve probably connected your Pi to the internet 
through Ethernet or WiFi, but have you ever 
considered using cellular? After all, your WiFi only 
covers a small portion of the planet. 

This tutorial explores using cellular with the 
Raspberry Pi family. Hologram. io recently released 
the Nova, a USB modem built for single-board 
computers like the Pi. The Nova, Hologram’s Python 
SDK, and Hologram’s global cellular network 
make connecting your Pi to the mobile phone 
network simple. 

This tutorial requires the Hologram Nova which 
includes a free SIM. Learn more at hologram.io/nova. 


Hologram SIM configuration 

Upon receiving your Nova and SIM, you need to 
activate the SIM to make the worldwide network 
available. From the Hologram Dashboard 
magpi.cc/2ijHyFn), click the Activate SIM button in 
the top right-hand corner. After activation you’1l be 
directed to the device list page. You should see your 
new device in the list; it may not be clickable while it 
provisions onto the network. 

Once the device is available, click it to be taken to 
the device details page. On the left you’ ll notice the 
device sub-navigation. For this tutorial we’ll need to 
configure a device phone number and Cloud Services 
credentials. Select Configuration in the side-nav and 
walk through Configure Phone Number and Cloud 
Services Router sections. Make sure to save the phone 
number and device key for later use. 
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CONNECT YOUR RASPBERRY PI WITH CELLULAR 


Activate your SIM 


inn G 


Miaa ane 


Hologram provides instant activation and SIM management 


through a self-managed dashboard 


Nova is a pretty 
versatile modem 
thanks to its 


open design and 
USB interface 


Local Pi configuration 
Next, we’re going to install all the dependencies 
this tutorial requires. Again, Hologram makes 
this very simple with a single-line command. It’s 
recommended you be connected to the internet 
through WiFi or Ethernet since these dependencies 
will use a lot of data. 

On the Pi, open a Terminal window and run the 
following script: 


curl -L hologram.io/python-install | bash 
For this tutorial we’ll need one more dependency: 
sudo apt-get install python-psutil 
You can now connect the Nova to your Pi. We’ll 
run the following code to verify everything is 
installed correctly. 
sudo hologram send —cloud "Hello World!" 
Along with the Python SDK, Hologram’s script 
installed a neat little command-line interface (CLI). 
Learn more about what the CLI can do by executing 


the following commands: 


hologram —help 
hologram modem —help 


Head over to the Hologram Dashboard 
(magpi.cc/2ijHyFn) to see your ‘Hello Nova’ 
command above. 


GJ nano 2.0. ile: askPishs.p 


For the SMS data to be routed correctly, 
you need to add the unique device key 
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>PYTHON 


Run SMS conversation script 

Let’s get the code so we can start talking with 
our Pi over SMS. From the Pi Terminal, clone the 
following repository. 


NAME: 
askPiSMS.py 


DOWNLOAD: 
magpi.cc/2ztwE3X 


git clone https://github.com/benstr/TUT- 
ask-pi-sms.git 


Remember the device key you generated in the first 
step? Paste the device key on line 6 of the script. 


cd TUT-ask-pi-sms 
sudo nano askPiSMS.py 


Save the file. You’re now ready to run the script 
and text your new robot friend, fingers crossed! 


sudo python askPiSMS.py 


From your phone, send the following questions 
to the phone number you received earlier. 


> What is your name? 
> How old are you? 

> Do you have a body? 
> How smart are you? 


By default, SMS is slow on all networks. Also, for 
simplicity, the code is not very fast. For both reasons, 
it might take 30-60 seconds to receive a response. 

Congrats, you have a new robot friend you can chat 
with! Modify the code to support more questions or 
add local AI to have a truly intelligent friend. 


December 2017 MägPi 


Tutorial 


55 


Lakka lets you relive the games of the past by enabling your 
Raspberry Pi to emulate a host of retro computers and consoles 


Input User 1 Binds 


B button (down) 
Y button (left) 
Select button 


Start button 


Up D-pad 


Down D-pad 
Left D-pad 


Right D-pad 


1 A button (right) 


1 


X button (top) 


L button (shoulder) 


(Key; rshift) 


(Key: enter) 


(Key: up) 


(Key: down) 
(Key: left) 


sy: right) 


21/11 14:05 © 


ENJOY EASY ENJOY EASY | Tutorial 


Mac OSX 10.8 Mountain Lion 
Mac OSX 10.7 Lion 


importa’ otice: 


SD interface Devices 


The following interface devices can be used to access SD/SOHC/SOXC memory 
cards: 


* SD Card slot on PC 
USB SO Card reader for US82.0, US83.0, USB3.1 & USB-C 


Always confirm that the device is compatible with the SO, SOHC or SOXC 
memory card before formatting. 


or Windows and 


= Copyright Notice 
Microsoft and Windows are either registered wademarks or trademarks of 
Microsoft Corporation in the United States and/or other countries. 
Apple, Mac, Mac OS, Mac O5 logo are either trademarks or registered trademarks 
of Apple Computer Inc. in the United States and/or ather countries. 


Beginners should start with NOOOS - New Out Of the Dox Software. You can 
Purchase a preinstalled NOOBS SD card from many retalers, such as Biosci 
ASSINA ING Line PLSS, OF Cownioad NOOBS below and follow the software sotu 
uide ond NOOBS actum guide vdeo in our hep 8068. 


NOOBS is an easy operating eyetem installer which containg Basotia It aiso 
provides a selection of akernative operating systems which are then donnioaced 
bom the ineenet and instalei. 


NOOBS Lite Contains the same operating system installer without Respbian pre 


loaded. It provides the same operating syste selection menu allowing Raspoien 
and other images to be downloaded and installed. 
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NOOBS v2.4 - Built: Mar 17 2017, 


fe) Wifi network selection 


Install (i) 


 Virginmedia % 
@ TALKTALKOB145F 

@ VM1755520 

| PS4-820BC94C27C1 


Authentication method 


© Pressing the WPS button on my wifi router 
@ Password authentication 


Username { ) 
pacsword [|] 


Raspblan (RECOMMENDED) 
A port of Debian Stretch for the Raspberry Pi (full desktop version) 


Ubre®LEC_RPO2 
P LibreELEC is a fast and user-friendly Kadi Entertainment Center dist 


Raspbian Lite 
A port of Debian Stretch for the Raspberry Pi (minimal version) 


a 
U TE perdial S T AEN PEEN EE ERE EEEE # 


OSMC Piz 
7, A fast and feature filled open source media center 


ROMs for Free Download 


Then it’s worth heading over the Lakka forums for 
friendly help and advice at: 


HackSpace - 


TECHNOLOGY IN YOUR HANDS 


1 NEW MAGAZINE 
Tae MODERN MAKER 


ae BECKY OEI 
SMOKE STERN 


ISSUE #01 


OUT NOW 


hsmag.cc 


FREQUENTLY 
ASKED QUESTIONS 


YOUR QUESTIONS ANSWERED 


NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


SD CARD 


MAINTENANCE 
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Corruption 

SD cards, like any form of computer storage, can 
become corrupted. This means certain (or all) sections 
of the memory become unreadable by a computer 

like the Raspberry Pi. In this case, your files will 

be generally irretrievable and the SD card will 

become useless. 


End of life 

Solid-state storage solutions like SD cards, USB flash 
drives and SSDs have a finite lifespan which is dictated 
by how much you use them. Don’t worry, though: you’re 
very unlikely to ever use your Pi’s SD card enough to 
break it that way. 


Physical problems 

SD cards, especially the microSD cards used in 

most Raspberry Pis, are small and flimsy. It’s not 
uncommon to lose them when transporting them 
somewhere and while they’ re not easy to snap, they 
are definitely breakable. 


Properly shut down 

Corruption usually occurs when data is being written 
and suddenly the storage is removed or there’s a loss 
of power. You should never remove the SD card while 
the Pi is running anyway, but you might remove the 
power to turn it off. Always make sure to shut it down 
via the Shutdown option in the desktop menu, or with 
the Terminal command sudo shutdown -h now. 


Boot to RAM 
Not every Pi is used in the same way, and sometimes 
you won’t be able to always turn it off properly. In the 
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case where you need to regularly pull the plug on it, 
you can use piCore (magpi.cc/2ueA7UI) as your distro. 
This loads into RAM at boot, so won’t be writing when 
you pull the plug. If you want to stick with Raspbian, 
try making it read-only: magpi.cc/2i1LkQ5. 


Keep it safe 

SD cards usually come with protective cases, which 
can aid in transporting them if you need to carry them 
around on their own. Otherwise, we find that keeping 
the card in a Pi we’re transporting (preferably in its 
own case) means it stays relatively safe and is hard 

to lose. 


Documentation and instructions 

The quickest and most low-tech way to back up your 
important files is simply to transfer them to a USB 
stick. You can also save files to another computer 
over the network, or simply plug the SD card into 

a computer that can read ext file systems and 

copy them. 


Cloud backup 

While services such as Dropbox and Google Drive 
don’t support Raspbian very well, you can set up 
Dropbox to manually sync files on the Raspberry Pi. 
With that in place, you can then automate the timing 
of this manual sync and have it behave almost like 
standard Dropbox: magpi.cc/2c9NnPC. 


Card clone 

Creating a complete 
copy of your SD card 
means you also get to 
save your software and 
settings along with your 
important files. You can 
create a copy using the 
SD Card Copier tool 
built into Raspbian, 
or simply plug the 
SD card into another 
PC and make a copy 
from there. 
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FROM THE RASPBERRY PI FAQ 
RASPBERRYPI.ORG/HELP 


WHAT SOC ARE YOU USING? 1.2GHz. Its GPU capabilities are equivalent to the Pi 2. 
All models of Raspberry Pi use Broadcom SoCs containing Some versions of the Pi 2 now use the same SoC as 
a VideoCore IV GPU, but with various ARM CPU cores. the Pi 3, but downclocked to match the speed of the 

The original Raspberry Pi used a Broadcom BCM2835. original Pi 2 SoC. In the future, every Pi 2 will use this 
This contains a single-core ARM1176JZFS with floating newer SoC. 


point, running at 7OOMHz, and a VideoCore IV GPU. The 
GPU is capable of Blu-ray-quality playback, using H.264 WHAT IS AN SOC? 


at 40MBits/s. It has a fast 3D core, accessed using the A system on a chip (SoC) is a method of placing all 
supplied OpenGL ES 2.0 and OpenVG libraries. necessary electronics for running a computer on 
The Pi 2 Model B originally used the Broadcom a single chip. Instead of having separate chips for 
BCM2836. This contains a quad-core ARM Cortex-A7 the CPU, GPU, USB controller, RAM, northbridge, 
processor with floating point and NEON, running at southbridge, and so on, everything is compressed 
QO0OMHz, and the same VideoCore IV GPU that is in the down into one tidy package. 
earlier models of Raspberry Pi. 
The Pi 3 Model B uses the Broadcom BCM2837 WHY DID YOU SELECT THE SOC? 
containing a quad-core ARM Cortex-A53 running at Cost and performance. 


INTRODUCING THE HOTTEST 
NEW PRODUCTS FOR YOUR PI 


www.shop.sb-components.co.uk Call: 0203 514 0914 
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CREATE YOUR OWN 


ADVENTURE 
» ¢ GAMEBOOK a mat 


with COs ° af 


i i t-based h Workshop co-founders St 
Using Twine 2, i ext-based games have orkshop co ounders eve 
: a legacy almost as long Jackson and Ian Livingstone added 
anyone can easily as modern computing. tabletop role-playing elements to 


create a choice- Created on a PDP-10 mainframe their Fighting Fantasy gamebooks, 
in 1975, Will Crowther’s Colossal the first of which, The Warlock of 


based interactive Cave Adventure is generally Firetop Mountain, was published 
fiction game and recognised as the first text by Puffin Books in 1982. With 
K.G. : : A adventure, allowing players to shorter passages, more choices, 
ORPHANIDES publish it online enter simple commands like GO a character sheet, and a dice- 
K.G. is a tech NORTH and TAKE LAMP. based combat system, Fighting 
journalist wose It inspired the entire Fantasy would define adventure 
experiments in text adventure genre, with gamebooks for generations of 
interactive fiction Infocom’s Zork (1979) and British kids. 
have ranged from Adventure International’ s It’s these that we’ll be taking 
Multi-User Shared P pwinels Adventureland (1978) inspiration from with this tutorial, 
Hallucinations to © becoming some of the first showing you how to implement 
gamebooks and hromium commercial parser-based not just a branching, choice-based 
traditional text E ination, text adventures. plot, but also exciting action, 
adventures. . o some Meanwhile, a different lucky rolls of the dice, and a 
aan paper kind of interactive fiction character who can be affected - 
was coming to bookshops. and even killed - by the challenges 
© In the UK, Games they face. 
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CREATE YOUR OWN DIGITAL ADVENTURE GAMEBOOK WITH TWINE | feature 
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INTRODUCING TWINE 
In this tutorial, we’re going 

to use Twine 2 and its default 
Harlowe programming language 
to create an interactive fantasy 
fiction adventure. Twine is 
specifically built to be easy to use. 
You can create a simple, choice- 
based story without writing a 
single line of code, but it also 
gives you a surprisingly flexible 
programming environment that 
you can use to implement logic, 
stats, event flags, and random 


THE ROAD TO ADVENTURE 
To go with this tutorial and illustrate the 
techniques used in it, we’ve created a demo 
game, The Road to Adventure™, which you can 
find online at 

To import it into your own copy a Twine, 
download the HTML source file linked on the 
main game page, open Twine, and select ‘Import 
from file’ on the right-hand bar of the Twine 
home screen. 


dice rolls. It runs in a browser, but all 
files are stored locally. Your 
INSTALLING AND game can be edited and built fully 
RUNNING TWINE 2 offline, but unlike some other 
Stand-alone Twine desktop implementations of the client, 
clients are available fora you’ll have to manually export 
number of systems, but not your works in progress (which 
ARM-based computers like the is actually best practice for all 
Raspberry Pi - for now, at any iterations of Twine). 
rate. However, there’s a ready- While Twine 2 should work 
made local web version of the perfectly in any JavaScript-enabled 
engine called TwineJS maintained browser, we’re going to run it in 
by original creator Chris Klimas, Chromium and we suggest that 
and all you need to run it is you do the same while following 
a web browser. this tutorial. 
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RESOURCES 
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Harlowe manual 


Publish for free on Itch.io 


FW nwew Ww nure 


e C O Me//Momekga Donninn 2.1 JANE MmT Atrones/aIded 0-2 aAr6-a5 19-3372505680 


he first time you run 
| Twine 2, a few tutorial 
paragraphs point you at 
some online documentation and 
tell you how to save your work. 
After that, yov’ll be taken to 
Twine’s main index screen, where 
we can begin writing our game. 


GETTING STARTED 

Click the green Story button 

in the bar on the right and name 
your tale when prompted. A graph- 
paper-like screen will appear with 
a single box in the middle, marked 
Untitled passage. Double-click on 
the box to open the editing screen 

Passage boxes are where 

you’ll spend most of your time 
in Twine. Click into the title 
bar - currently marked Untitled 
Passage - and give it a name. 
Only you will be able to see this 
title, so you can call it whatever 
you like, as it won’t be visible to 
the player. 

Below is the main box where 
you’ll enter text for your players to 
read. As it suggests, double-click 
on the sample text currently in the 


passage and start typing to begin 
composing your own story. 
There’s also a Tags box, invisible 
to the player, which you can use 
to mark passages for your own 
reference or to apply repeated text 
or code to your game, for example 
in header and footer passages. 
While this is beyond the scope of 
our tutorial, you can learn more 
about it in Twine’s documentation. 
Everything you type ina 
passage is automatically saved 
to your browser’s cache in real 
time. This means that, even if your 
computer crashes, nothing will be 
lost. However, it’s very important 
to back up your game (see ‘Save 
often’) before making any major 
changes to its text or code. 


YOUR FIRST LINK 

In our first gameplay passage - 
called Spitz Adventurers’ Guild 
Barracks in our demo game - 
we’ve described the barracks 

of an adventurer’s guild and 

set up the plot for our story. 
Our character’s motivation is 
simple: hunt monsters for fame 


|... .H_o__oé ——<_.|. ll asd 


Each box represents a passage of text, 
with arrows indicating direct links 
between one page and another. 
Double-click on a passage box to edit it 


Opened by clicking on your story's 
name, the story menu gives you tools 


to edit the way your story is displayed, 
rename it, and publish it 


Mouse-over any passage and icons 
allow you to delete, edit or test it, or 
set it as the game's starting point 


ga == 


Click the Passage button to create a 
new text passage. New passages are 
also automatically created when you 
write linking code in any passage 


tee 


f The Road to Adventure a 
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and fortune. But now we’ve got 
to get them to the next stage of 
their adventure. 

To do this, we’re going to create 
a simple link. When using Twine 
and Harlowe, any string of text 
you put between two sets of square 
brackets [[like this]], Twine 
will automatically create a passage 
with the same name as your link. 
With that done, click the X in the 
top right to close. 


MAKE ROOM, 
MAKE ROOM 
Back on the map screen, you’ll 
see that a new passage has been 
created. If we rename it, the link 
pointing to it will be automatically 
updated to reflect this. However, 
you can also create a link that 
points to a passage with a name 
that’s different to the link text. 

In our code example (see 
‘A link to the future’) we 
have used different linking 
methods, one of which involves 
the same bracketed format we 
used earlier, but with an arrow 
pointing at the new passage name 
[[so this->leads to this]]. 


A third method involves our first 
introduction to Harlowe’s built- 
in macros. The (link: ) macro 
makes a link that will appear on 
our current page. When the player 
clicks on it, the game will carry 
out any commands within a pair 
of brackets that follow it. 

In this case, that’s just a 
(goto: ) macro, which will do 
the same job as a normal link. 
However, it doesn’t automatically 
create your destination passage 
and won’t display a link arrow on 
the map view. 

That means that if we create a 
passage with this bit of code in it 
- (link: “Go north”)[ (goto: 
“Town gate”) ] -we then have 
to manually create a new passage 
called Town gate, because one will 
not automatically be created when 
using this method. 

We’ll generally only use this kind 
of link when we need to call other 
functions when it’s clicked. Later, 
we’ll be using (link: ) to tell 
Twine to set variables, check for 
previously set states, and carry out 
random dice rolls as we move from 
one passage to the next. 


€ C © Meiihemekg/Downlondatwine_2.1.J/indexhtmia stories 


2 Stories 


A main index page - which you can 
return to using the Home icon on your 
story map - lists all your creations 
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ow we’ve got to grips with 
linking passages - the 
most fundamental aspect 
of Twine - we can move on to using 
more of Harlowe’s macros and 
stringing them together to add 
gameplay to our interactive story. 


BRACKETS ARE 
REALLY IMPORTANT 

In any programming language, 
structuring your code correctly 
is important when it comes to 
making it human-readable and 
ensuring that you’ve got all your 
punctuation in the right places. 


Twine helpfully has built-in 
syntax highlighting to make it easy 
to see which bits of your code go 
with each other, but you’ll also 
want to make sure you don’t lose 
track of how many square brackets 
you’re using. 

When using conditional macros 
such as (if: ), (else-if:), and 
(else: ), remember that anything 
that happens in response to those 
conditions must be placed between 
a pair of [square brackets]. 

You can nest multiple macros 
in these, so although it’s 
not essential for the correct 


functioning of your program, it a 
good idea to use tabs and carriage 
returns to keep large blocks of 
code tidy - see our examples 

for a demonstration. 

Twine automatically saves every 
change you make instantly, and 
you can’t rely on a CTRL+Z undo 
function if you accidentally delete a 
line you wanted. 

Save regular copies of your work 
and when working on a complex bit 
of code, it’s a good idea to cut and 
paste it to a new passage to make 
it easier to revert to the original 
version if required. 


VARIABLES (SET:) 
UP THE STORY 
In our character creation code 
(see ‘Set your stats’), we’ve used 
macros to define our hero’s name, 
hit points, attack, luck, and a few 
other stats. We start by asking the 
player to name their hero, which 
we’ll use the (set: ) macro to save 
as a variable called $name. The 
(prompt: ) macro creates a text 
entry box. The second bit of text in 
quotes, "Avatar", is the suggested 
text for the entry box, in case the 
player doesn’t want to come up 
with their own name. 

Everything else is set when the 
player clicks the ‘It’s time to go’ 
link. The (link: ) macro defines 
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the text the player sees. Then 

we use (set: ) macros to set our 
variables. Here, $luck is set to 

the number 7. If you’re setting a 
variable to a text string, such as 
our $battlecry variable, you have 
to enclose it in inverted commas. 

The final (goto: ) line tells 
the program where the link will 
go after everything has been set. 
From now on, any time we put 
$name or $luck into the text of 
a passage, the game will display 
those variables. 

So if we create a passage 
introducing a tavern keeper, she 
can say "What ho, $name! Come 
over and have a drink!", and 
the player character’s name will 
appear in the sentence. 


ROLL THE BONES 
Rolling dice - or rather, generating 
random numbers - is a key factor 
of games and is also really simple 
to do using Harlowe. Just use the 
(random: ) macro with the bottom 
and top of the random number 
range you want. To roll a six-sided 
die, you put (random: 1,6), and 
Twine will spit out the result. To 
make it part of a game, we’ll use it 
to roll against a stat. 

The ‘Roll for luck’ box code 
demonstrates one way of doing this. 
Our (link: ) shows the player a 


link saying ‘Swim for it - roll for 
luck’. Telling the player when 
they’re rolling dice helps to create 
the feel of a gamebook. 

Here, we (set: ) a variable 
called $ro11 to the result of a 
(random: ) number between 1 and 
10, to simulate a ten-sided die. 

(if: ) the character’s $luck 
stat, which we (set: ) during 
character creation, is greater 
than or equal to (>=) the random 
number we stored in the $rol11 
variable just now, our hero swims 
to safety and, when they select 
Continue, washes up in an area 
called ‘Beneath the docks’ thanks 
to a (goto: ) command. 

As this is a simple either/or 
situation, we can use the basic 
(else: ) command to handle 
what happens otherwise. So, 
if the player’s luck is less than 
the random number, they’re 
sent to a passage called ‘You 
have drowned’ using a (link: ) 

[ (goto: )] macro command. 
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As the door clangs shut behind you, water starts pouring into 


the small room. The murky, stinking liquid is alread: 


height, but you saw an an outflow pipe across the room that 


shut behind you, water starts pouring into 


e murky, stinking liquid is already at waist 


outflow pipe across the roon tha 
mr 


you might just be able to fit through: 
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Me 


Integrated debug tools help 


you see where a piece of THE SETUP 


code is failing 


THE FIGHT 


FIGHT ME 

It’s not a classic fantasy adventure 
without a bit of monster-bashing, 
so our final section of sample 

code shows you how to set up a 
combat routine. 

The nice thing about this bit 
of code is that you can reuse it 
anywhere you like with only a few 
tweaks to change the name of the 
monster, set by the $monster 
variable; its hit points, set in 
$mob_hp; and its base attack, 
defined by $monster_atk. 

These are all defined using the 
(set: ) command with a link that 
goes from a previous passage to the 
combat sequence itself. They’re 
locked in when the player selects 
the ‘Fight the skeleton’ link. 

The combat sequence is designed 
as a loop that responds to the 
player’s decisions. Each loop 
represents one round of combat. 
If neither the player character 
nor the monster are reduced to 
zero hit points during combat, the 
player will be given the option of 
either escaping or continuing with 
another round of combat. 

At the beginning of each round, 
the game rolls a ten-sided die 
for both player and monster. The 
results are added to their base 
attack stats. Whoever has the 
highest score knocks two hit points 


THE PAYOFF 


equal, neither hits. 


D off the other. If both scores are 


Note that we use greater than (>) 
or less than (<) signs for most of 
these comparisons, but if we want 
to see if their attacks equal each 
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other, we have to use the word is, 
asin (else-if: $mob_atk is 
$hero_atk) [outcome]. 

The whole routine is very simple, 
but it does the job. As you become 
more familiar with Harlowe, you 
could add extra features, such as 
modifying the $atk variable to 
increase the amount of damage 
the player does if they get a shiny 
new axe, Or requiring a luck 
roll to successfully escape from 
the monster. 

If the player dies, we offer them 
the opportunity of restarting the 
game from the beginning. By 
default, Twine has a back button, 
so they’ll probably just flip back to 
before the fight started - as most 
people do with physical gamebooks 
- but the (reload: ) link is great 
for people who want to play an 
honest game or if you use Twine’s 
Stylesheet editor to remove the 
back button. 

If the player wins the fight, then 
we take them to a victory screen 
where we can award them loot, 
move them further along a fixed 
story path, or - if we want them 
to be able to return to the same 
location in the future - (set: ) 

a variable to mark the enemy as 
defeated so that it doesn’t appear 
a second time. 


DEBUG ZAPPER 

Twine has a built-in debugging tool 
that’ll help you spot where and 
why your code is going wrong. To 
run the game from the beginning 
in the debugger, use the Test 
button at the bottom of your 
game’s main map display. 

The test interface runs your 
game while tracking turns, the 
passage title, and set variables 
at the bottom right. To see more 
details of the code, press the 
Debug View button. You can also 
test individual passages via the 
bug icon that appears when you 
mouse-over any passage, but 
remember that it’ll run without 
any variables that you might have 
set in previous passages. 


ADD MULTIMEDIA, 
PUBLISH YOUR GAME 


ALL SINGING, 
ALL DANCING 
Twine 2 has a reputation for being 
less multimedia-friendly than 
Twine 1, which could encode images 
as part of its game file, but it’s really 
very simple to use HTML to include 
pictures, sound, and even video. 

To add pictures and join the 
long tradition of text-and-graphic 
adventure development, just 
use HTML <img> tags to display 
images and <audio> tags for sound. 

If you want to publish your game 
online, your sound and images will 
have to be hosted somewhere. In 
this tutorial, we’re going to use 
itch.io to publish our game, and it 
can host your images for you. That 
means you can just put them in the 
same directory as your game file and 
use their file name to refer to them 
in your code, rather than a full URL. 

You can also embed YouTube 
videos, which can be effective if 
you want to add cut-scenes toa 
fantasy adventure, or interviews 
with suspects to a murder mystery. 
Just upload your video to YouTube, 
copy the embed code from 
YouTube’s Share options, and paste 
it into the Twine passage you want 
it to appear in. 


PUBLISH AND BE QUITE 
CHEERY, ACTUALLY 
The beauty of a Twine game is that 
it exists as a single HTML file that 
you can upload anywhere that you 
have a bit of web space. There are 
also free hosts that specifically 
cater to Twine developers. 
However, if you want a polished 
and professional set of tools for 
publishing and even monetising 
your games, we recommend setting 
up a free account on itch.io. 
Whether you want to distribute 
your games for free, set up a 
donation box for your fans, or 
release games commercially, 
itch.io’s tools make the job 
simple. You can upload blogs, 


Climbed multimedia 
using HCML 


HTML code can be placed anywhere within a passage. 


Embed and centre an image: 


<center><img src="yourimage.jpg"; alt="victory 


gate"></center> 


Embed a sound file: 


<audio src="youraudiofile.mp3"; autoplay> 


Embed a YouTube video: 


<iframe width="560" height="315" 
src="yourYouTubevideoURL" frameborder="0" 


allowfullscreen></iframe> 


Or use YouTube’s share and embed options to 
automatically generate the correct code. 


Itch.io provides free tools to 
publish, market, and even 
monetise your own games 


screenshots and videos to keep 
players up-to-date, it’s ad-free, 
and it can even handle VAT MOSS 
payments on your profits for you. 

Once you’ve created an account, 
go to My Dashboard and hit 
‘Create new project’. From there, 
all you have to do is enter a title, 
a description, a cover image, and 
upload the HTML file. 

Remember to tick the ‘This file 
will be played in the browser’ 
box, and then enable the ‘Mobile 
friendly’, fullscreen, and scrollbars 
options further down the page. 

If you have graphics or audio 
that you want to include, just 
put them in a directory with your 
HTML file, which has to be called 
index.html, zip the whole thing 
up, and upload the zip file. 

You can preview the game’s 
page as a draft version to make 
sure everything works properly 
before you hit Publish to release 
your masterpiece. 


— 
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= © » | ow that you’ve learned how to design and 
: sa } build a text adventure, it’s time to learn to 
oe aS code your own. In this project, you’ll design 


and code your own RPG maze game. The aim of the 
game will be to collect objects and escape from a 
house, making sure to avoid all the monsters. 

This project teaches game design through the 
development of an RPG maze game. In this game, 
the player has to pick up objects within a house 
and get to a specific room, while avoiding monsters 


lurking in some of the rooms. This game will be 


achieved by manipulating dictionaries and lists. 
Start by opening up Thonny (Programming > 
Thonny Python IDE) and enter the code from rpg.py. 
This is a very basic RPG game that only has two 
rooms. Figure 1 shows a map of the basic game. 
SeSUCHOD ~ Choose File > Save and save the code as rpg. py. 
m P Click the Run icon to test out the code. You can type 
go south to move from the hall to the kitchen, and 


b r " then go north to go back to the hall again! Type 
Coding a text adventure is a classic Way go west in the hall and you’ll get a friendly error 


. e 6 5 1» 
to learn programming. Discover how to ™°ss28e: “You can't go that way: 
x Click Stop and look at this part of the code: 
make your own adventure in Python 


rpa.py magpi.cc/2jbnPol 


01. #!/bin/python3 

02. 

03. showInstructions(): 

04. #print a main menu and the commands 

o5. Cy 

06. RPG Game 

07. Each room is a dictionary, and rooms are linked 
08. Commands: together using directions. Let’s add a dining room to 


@9. go [direction] your map, to the east of the hall (as shown in Figure 2). 
10. get [item] 


11. uf ") 
123 
ile}, showStatus(): 


e Raspberry Pi 
e Python 


¢ Some ideas 


14. #print the player's current status 
157 


16. (‘You are in the ' + currentRoom) 
17A #print the current inventory 

18. (‘Inventory : ' + (inventory) ) 
19. #print an item if there is one 

20. if “item” in rooms[currentRoom]: 

21 (‘You see a ' + rooms[currentRoom]['item']) 
227 

235 

24. #an inventory, which is initially empty 

25. inventory = [] 

26. 

27. #a dictionary linking a room to other rooms 
28. rooms = { 

297 


Map of the basic game 
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Dining Room 


Figure 2 Now we've added a third room to the game 


You need to add a third room, called Dining Room. 
You also need to link it to the hall to the west. In 
addition, you need to add data to the hall, so that 
you can move to the dining room to the east. 


#a dictionary linking a room to other room 
positions 
rooms = { 


"Hall' : { ‘south’ : ‘Kitchen’, 
‘east’ : ‘Dining Room’, 


J 


"Kitchen' : { 'north' : 'Hall', 
} 


'Dining Room' : { 'west' : 'Hall', 


} 


Try out the game with your new dining room. You 
can now go east and go west between the hall and 
dining room. If you can’t move in and out of the dining 
room, just check that you added all of the code above 
(including the extra comma after the Kitchen section 
of the code). 


ADDING ITEMS 


Adding an item into a room is easy: you can just add it 
to a room’s dictionary. Let’s put a key in the hall. 


#a dictionary linking a room to other room 
positions 
rooms = { 


'Hall' : { 'south' : 'Kitchen', 
'east' : 'Dining Room', 
'item' : 'key' 


}, 
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34. 
35. 
36. 
37. 
38. 
39. 
40. 
41. 
42. 
43. 
44. 
45. 
46. 
47. 
48. 
49. 
50. 
51. 
52. 
53. 
54. 
55. 
56. 
57. 
58. 
59. 
60. 
61. 
62. 
63. 
64. 
65. 
66. 
67. 
68. 
69. 
70. 
71. 


72. 


73. 
74. 
75. 
76. 
77. 
78. 
79. 
80. 
81. 
82. 
83. 


> { 
} 
} 
#start the player in the Hall 
currentRoom 
showInstructions() 


#loop forever 


showStatus() 


#get the player's next 'move' 
#.split() breaks it up into an list array 
#eg typing 'go east' would give the list: 
#['go','east'] 
move 
while move 

move = input( ) 


move = move.lower().split() 


#if they type 'go' first 


move[@] : 
#check that they are allowed wherever they want to go 
move[1] rooms [currentRoom] : 


#set the current room to the new room 
currentRoom = rooms[currentRoom][move[1]] 
#there is no door (link) to the new room 


pranti ) 


#if they type 'get' first 
move[9] ; 
#if the room contains an item, and the item is the 
one they want to get 
rooms[currentRoom] move[1] 
rooms[currentRoom][ ]: 
#add the item to their inventory 
inventory [move[1]] 
#display a helpful message 
print(move[1] ) 
#delete the item from the room 
rooms[ currentRoom] [ ] 
#otherwise, if the item isn't there to get 


#tell them they can't get it 
print( move[1] ) 
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pa-finished.py magpi.cc/2jbnPol 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
030. 
031. 
032. 
033. 
034. 
035. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 
050. 
051. 
052. 
053. 
054. 
055. 
056. 
057. 
058. 
059. 


#!/bin/python3 


showInstructions(): 
#print a main menu and the commands 


Gy 
RPG Game 


Get to the Garden with a key and a potion 
Avoid the monsters! 


Commands : 
go [direction] 
get [item] 
re) 


showStatus(): 

#print the player's current status 
G 9) 
(‘You are in the ' + currentRoom) 

#print the current inventory 
("Inventory : " + (inventory)) 


#print an item if there is one 
if “item” in rooms[currentRoom]: 
('You see a 


+ rooms[currentRoom]['item']) 


C ) 


#an inventory, which is initially empty 
inventory = [] 


#a dictionary linking a room to other room positions 
rooms = { 


'Hall' : { 'south' : 'Kitchen', 
'east' : ‘Dining Room’, 
‘item’ : ‘key’ 

}5 

‘Kitchen’ : { ‘north’ : ‘Hall’, 

‘item’ : 'monster' 
h 
"Dining Room' : { 'west' : 'Hall', 
'south' : 'Garden', 
‘item’ : 'potion' 
}5 
"Garden' : { ‘north’ : ‘Dining Room' 


} 


#start the player in the Hall 
currentRoom = ‘Hall’ 


Q 


#loop forever 
while Tru 


Remember to put a comma after the line above the 
new item (after ‘Dining Room’ here), or your program 
won’t run. 

If you run your game after adding the code above, 
you can now see a key in the hall, and you can even 
pick it up (by typing get key), which adds it to 
your inventory. 


ADD ENEMIES 
This game is too easy! Let’s add enemies to some 
rooms that the player must avoid. 

Adding an enemy to a room is as easy as adding 
any other item. Let’s add a hungry monster 
to the kitchen: 


You want to make sure that the game ends if the 
player enters a room with a monster in. You can do 
this with the following code, which you should add to 
the end of the game: 


This code checks whether there is an item in the 
room - and if so, whether that item is a monster. 
Notice that this code is indented, putting it in line 
with the code above it. This means that the game will 
check for a monster every time the player moves into 
a new room. 

Test out your code by going into the kitchen, which 
now contains a monster. Type go south and you will 
see ‘A monster has got you... GAME OVER!’ 


e 
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Figure 3 The final map of our adventure game 


WINNING THE GAME 
Let’s give your player a mission which needs to be 
completed to win the game. 

In this game, the player wins by getting to the 
garden and escaping the house. They also need to have 
the key with them, and the magic potion. Figure 3 
shows a map of the final game. 

First, you need to add a garden to the south of the 
dining room. Remember to add doors, to link to other 
rooms in the house. 

Add a potion to the dining room (or another room in 
your house). Finally, add this code to allow the player 
to win the game when they get to the garden with the 
key and the potion: 


# player wins if they get to the garden 
with a key and a shield 
if currentRoom == ‘Garden’ and 'key' in 
inventory and 'potion' in inventory: 
print('You escaped the house... YOU WIN! ") 
break 


You can see the final code in rpg-finished.py. 
Finally, check your game to make sure the player 
can win! Enter the following commands: 


get key 
go east 
get potion 
go south 


You will see ‘You escaped the house... YOU WIN!’ 

Use what you’ve learnt to create your own game. 
Add lots of rooms, monsters to avoid, and items to 
collect. Remember to modify the code so that the 
player wins when they get to a certain room with some 
of the objects in their inventory. It may help you to 
sketch a map before you start coding. 


ee 


raspberrypi.org/magpi 


062. 
063. 
064. 
065. 
066. 
067. 
068. 
069. 
070. 
071. 
072. 
073. 
074. 
075. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
085. 


086. 


087. 
088. 
089. 
090. 
091. 
092. 
093. 
094. 
095. 
096. 
097. 
098. 
099. 


100. 
101. 
102. 
103. 


104. 


showStatus() 


#get the player's next 'move' 

#.split() breaks it up into an list array 
#eg typing 'go east' would give the list: 
#['go','east'] 


move 
move 8 
move = input( ) 
move = move. lower().split() 


#if they type ‘go' first 


move[@] 5 
#check that they are allowed wherever they want to go 
move[1] rooms[currentRoom] : 


#set the current room to the new room 
currentRoom = rooms[currentRoom][move[1] ] 
#there is no door (link) to the new room 


print( ) 


#if they type 
move[@] 
#if the room contains an item, and the item is the one 
they want to get 
rooms[currentRoom] 
rooms[ currentRoom] [ Je 
#add the item to their inventory 
inventory [move[1]] 
#display a helpful message 
print(move[1] ) 
#delete the item from the room 
rooms[currentRoom][ ] 
#otherwise, if the item isn't there to get 


'get' first 


move[1] 


#tell them they can't get it 
print( move[1] ) 


# player loses if they enter a room with a monster 
rooms[currentRoom] 
rooms[ currentRoom] [ ig 
print( ) 


# player wins if they get to the garden with a key and 
a shield 
currentRoom 
inventory: 


inventory 


print( ) 
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only at BuildPiper.com 


“Its a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff” Mii ° 
api 


Want to learn how to bring Piper to your school? 


buildpiper.com/EDU 


THE PIPER EXPERIENCE 


s T, 
SOFTWARE-BASED CURRICULUM CREATE YOUR ELECTRONICS 


Supported by Top University Funds 
; r Stanford-StartX Fund 


AEF of Princeton University 


Available at: 
PPLE} 
BuildPiper.com amazon ysu BARNES &NOBLE 


Maker 
Says 
Level 

up your 


Raspberry Pi 
Monster Joysticks 


DELUXE ARCADE CONTROLLER KIT 


DELUXE ARCADE 
CONTROLLER KIT 


Rob Zwetsloot builds a mini arcade machine with this all-in-one 
controller kit from Monster Joysticks 


PICADE 
CONSOLE 


The product 
that launched 
Pimoroni is 
very similar to 
the Monster 
Joysticks 
version, 
although it 
has a slightly 
nicer case. 


£90 / $120 
magpi.cc/2i1H82R 


n the last issue of The MagPi 

we took you through a 

comprehensive arcade 
machine build, including a complete 
wooden build of the cabinet itself. 


While it’s certain 
not everyone has 
or money for one. 


awesome little kit 


y impressive, 
the space, time, 
This is where 
s like this one 


from Monster Joysticks come in. 
You’ve probably seen this type 
of kit before — it’s an all-in- 
one arcade joystick and case for 
your Raspberry Pi that turns it 
into a small and portable arcade 
machine. Just hook it up to the 
nearest television and you’re ready 
for some Elevator Action. It’s like 
the plug-and-play mini Mega 
Drive you got for Christmas a few 
years ago, or the SNES Classic Mini 
you missed out on this year due to 
limited stock. Thanks, Nintendo. 
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Unlike the stocking filler 
plug-and-play consoles, this kit 
requires you to build your gaming 
system and supply the Raspberry 
Pi that powers it. Construction is 
very simple, though: there are six 
acrylic panels for each side of the 
box and only eight screws required 
to fasten them all together. 


Quality components 
The kit comes with nine genuine 
Sanwa arcade buttons and a Sanwa 
joystick, which just simply click 
into the acrylic panels as you 
build them. 

To wire up the buttons and 
joystick, a little add-on board 
is provided with colour-coded 
wires. They can be a little 
tricky to properly attach to the 
connections as the connectors 
themselves are a bit tight, 


but you don’t have to worry 
too much about wires getting 
tangled up. You may also need 
to push down the top panela 
bit due to resistance of all the 
wires, but otherwise it all fits 
fairly neatly inside. You can find 
the full build instructions on 
the Monster Joysticks website: 
magpi.cc/2i3iQps. 

The build took us just shy 
of three episodes of The Simpsons, 
so make sure you set aside about 
an hour for the job. Our only 
real complaint about the build 
is that, while all the ports and 
even SD card slot are readily 
accessible, the Raspberry Pi 
can only be removed by taking 
the case apart. It will only take 
a couple of minutes to remove 
it, but we’d have preferred it to 
be a little easier. 
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The final part of the build 
involves attaching little rubber feet 
to the bottom — very welcome, as 
the case had been slipping a bit on 
the glass table it had been built on. 
The stick feels solid and has a 
decent weight to it thanks to the 
included components, so you feel 
pretty safe giving the buttons and 


customised: the version that comes 
with the kit has square four-way 
gates, but they can be upgraded to 
an octagonal eight-way gate, or 
any other gate style if you prefer. 


Quick configuration 
Software customisation for 
RetroPie is also very simple. 


The stick feels solid and has a 
decent weight to it thanks to 
the included components 


joystick a proper workout. The 
included Sanwa components are 
quite important as not only are 
they high-quality and can survive 
a bit of classic Street Fighter 
button mashing/frame-perfect 
combo-timing, they’re also quite 
customisable. For instance, if 
you don’t fancy the button colour 
scheme, you can always swap them 
out. The joystick itself can also be 
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With a custom add-on board to 
connect the controls to the Pi over 
GPIO, we initially feared we’d have 
to download custom scripts for the 
job. Not so, though, and while you 
do need to go into the RetroPie 
configuration menu and install 

an extra driver (snesdev), it’s all 
quick and included in the RetroPie 
archive. Once that’s done, you 

can configure the stick controls, 


as well as any extra controllers 
you’ve plugged into the USB ports. 
Co-op Contra, anyone? 

This kit is a great, solid package 
and it looks good as well. We 
recommend investing in some 
nice, long HDMI and USB cables 
to power the box and don’t be 
afraid to put some sticks or a 
little custom decal onto the case 
as well. With Christmas coming 
up, it may just be the perfect gift 
for someone, especially if they 
missed out on the aforementioned 
SNES Mini. 


A great little kit. It's a fun 
build but also a good 
quality product to use. We'd 
prefer the Raspberry Pi to 


be a bit more accessible, 
but otherwise the high 
customisability is a big plus. 


kek 
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KITS FOR 


CHRISTMAS 


We look at some Raspberry Pi kits that are perfect for the holiday season 


The 
perfect 
stocking 
filler for 
any geek 
with an 
interest in 
electronics 


and the Pi 
The Pi Hut 


3D XMAS 


Rob Zwetsloot starts Christmas 
decorating with this fun add-on 


for the Raspberry Pi 


f you watched our video 

on the Pimoroni Unicorn 

HAT HD (youtu.be/ 
b4ItGerg9qio) a little while back, 
or keep an eye on our Twitter feed, 
you’ll know that our features 
editor Rob was using the Unicorn 
HAT HD to count down toa 
forthcoming holiday. Now that’s 
been and gone, it’s time to replace 
it with something else and what 
better than a little festive add-on 
for the Christmas season? 

The 3D Xmas Tree acts very 
much like a HAT for the Raspberry 
Pi, sitting neatly on top of the 
GPIO pins. However, it doesn’t 
cover the top of the Pi and, due 
to the ‘3D’ nature of the design, 
it also hangs off the edge. Still 
though, it’s neat to just slot on. 

The £12 price is for the 
unsoldered version which you need 
to assemble yourself, but there is 
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Digital 
Soldering 
Station 


also a £15 ($20) version that comes 
pre-soldered. We’re always up for 
a bit of soldering, so were happy 
to get a soldering iron out when 
the unsoldered version arrived. 
However, due to the nature of the 
tree, it’s a little bit of a chore. 25 
resistors and 25 LEDs need to be 
individually soldered to the board 
along with a 40-pin GPIO header 
and, while it’s perfectly fine and 
pretty easy, the repetition is 
noticeable. Still, we constructed 
the tree in about 45 minutes or so. 
Programming the tree is a 
doddle and makes good use of 
the LED and LEDBoard classes 
in the GPIO Zero Python library 
on the Raspberry Pi rather than 
using its own dedicated software. 
The example code on The Pi Hut 
product page (magpi.cc/2iZCkel) 
is enough to get you started and 
you can easily modify it to make 


=. 


your own little light routine with 


some quick tinkering. 


We like this kit as it looks great 
once finished and it’s pretty 
customisable as well: don’t want 
all the main LEDs to be red? 


Remove them and add s 


ome 


multicoloured alternatives! For 


now, though, we’re just 
have the standard red LI 
at our desk while we wo 
next year. 


going to 
EDs flash 
rk. Maybe 


A great little Pi-themed 


decoration that can fi 


t almost 


anywhere you want it to. 
We suggest spending a bit 


more on the pre-sold 
version, though. 


Kkkk 
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THE OFFICIAL 
RASPBERRY PI 


The latest edition of our Projects Book is out and comes 
with 200 pages packed with awesome projects, amazing 
guides, and very helpful product reviews. We think it's 

a perfect little book for newcomers to Raspberry Pi or 
people wanting to learn a bit more about making. At the 
very least, it should keep the younger computer whizzes 
occupied until a more reasonable present-opening hour. 


ef hagoa 
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KITS FOR CHRISTMAS 


While not Raspberry Pi-powered, these adorable wearables from Pimoroni 
can be a first step into electronics for someone more on the crafting side 
of the maker spectrum. They can be easily sewn onto fabric and can even 
use conductive thread to attach sensors as well. The base can then be 
customised to suit someone's individual style - a fun little project during 
the afternoon. You can also hack them if you know how... 


STARTER KIT 


A perfect little kit for someone that asked for a Raspberry Pi for Christmas. 
This kit includes a Raspberry Pi Zero W along with a case and a Blinkt! LED 
strip, so you can get started doing cool stuff with your new Pi Zero straight 
away! It's also a pretty small case, so it’s easy to hide for a big surprise. 
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RASPBERRY PI 
BESTSELLERS 


Books which probe and question this internet 
that we've all begun to take for granted. 


PROGRAM OR 


BE PROGRAMMED — 


Author: Douglas Rushkoff PROGR AM 

Publisher: OR Books OR BE 

Price: £10 pROGRAMME 

ISBN: 978-1935928157 amano 
uc? At 

magpi.cc/2zqLQiS oA rant Ae 


Still essential reading, Rushkoff's | 

2010 call for everyone to learn | q 
programming was part of a wave | 

that led to Code Club and the ! 
Pi, and the arguments are well 
worth revisiting. 


HACKING POLITICS 


Authors: David Moon, 
Patrick Ruffini, 
David Segal 

Publisher: OR Books 

Price: £20 

ISBN: 978-1939293046 

magpi.cc/2zr6q2y 


„ø politics 
Hackir gt 


The extraordinary story of the 
2012 internet blackout, and the 
successful campaign to stop 
SOPA, which would have removed 
numerous domains from the 
internet, told in the collective 
voices of those involved. 


SPLINTERNET 


Author: Scott Malcomson —<—— 
Publisher: OR Books 


apLINTERNE" 
Price: £13 SPE 
ISBN: 978-1682190302 j 


magpi.cc/2zqn3v5 


“A contested, protean terrain, \ 
constantly evolving as different ; 
forces intervene to drive it | ww 
forward.” The internet's (military) — "i 

history, and fragmented present yaroo | 
- driven by politics, money, and J 
conflicting idealism (hacktivists pe- 

versus netizens). j 
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ADVENTURES IN 
RASPBERRY PI 
— 38RD EDITION 


Author: Carrie Anne Philbin 
Publisher: Wiley 

Price: £20.99 

ISBN: 978-1119269069 
magpi.cc/2zt24rO 


New to Raspberry Pi? 
Want your children 
to learn coding and 
have fun connecting 
up lights, sensors, or even 
marshmallows? Or even use the Pi 
to make a dedicated device? You’ve 
come the right place. Philbin 

is a technology educator with 
plenty of experience of bringing 
alive the Pi’s possibilities fora 
young audience. 

After setting up the Pi, and 
learning some command-line 
basics, readers get to try using the 
Scratch programming language 
to animate a monkey sprite, then 
start building a role-playing game, 


HIGH PERFORMANCE 


SPAR 


Authors: Holden Karau 

& Rachel Warren 
Publisher: O'Reilly 
Price: £31.99 
ISBN: 978-1491943205 
magpi.cc/2yg93CX 


Apache Spark is a great 
tool for querying large 
data sets, but doesn’t it need 

big hardware to run on? In fact, 

in The MagPi #38, Sung-Taek Kim 
extolled the virtues of a small 
Raspberry Pi cluster for learning 
and experimenting with Spark, in 
an article that highlighted a typical 
data science stack of Python-based 
NumPy, SciPy, and Scikit-Learn, as 
well as Java. 

Sung-Taek also mentioned the 
importance of learning a little 
Scala, and it is that language 
that Karau and Warren propose 
as the best way to work with 


Carris Anne phi 


SCs 


High Performance 


park 


before diving into Turtle graphics 
to make shapes with both Scratch 
and Python. Sonic Pi continues the 
coding ~- making music with Ruby 
code. Throughout these divergent 
adventures, additional 
notes, definitions, and 
tips and tricks combine 
with the lessons to 
more broadly educate 
new programmers. 
The last chapters are 
on hardware: using the 
GPIO with those sensors 
and marshmallows, and 
building a Pi jukebox. Readers who 
already have the second edition 
(see The MagPi #32) will want to 
know what’s new — a whole extra 
chapter on experimenting with 
cameras, and expanding your Pi’s 
capabilities with add-on HATs — 
but won’t need any persuasion 
to buy extra copies as Christmas 
presents for young relatives! 


Score 


Spark — although Python is not 

entirely forgotten here. Language 

choice justified, the authors give 

a pithy introduction to the how 
and why of Spark, and 
where it fits in the ‘Big 
Data Ecosystem’. 

This is a practical 
book, and the middle 
section takes the reader 
through data operations 
from loading, through 

optimised queries in 
Spark SQL, to join types, 
and transformations. After a 
chapter on working with key/value 
data, with a worked example of 
‘Goldilocks data’ showing different 
approaches and pitfalls, coverage 
extends to further languages 
(Julia, R, et al.), testing, machine- 
learning libraries, and the broader 
Spark ecosystem. An insightful 
Spark introduction. 


Score 
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ALGORITHMS AND 
NETWORKING FOR 


COMPUTER GAMES 


Authors: Jouni Smed 

& Harri Hakonen 
Publisher: Wiley 
Price: £60 
ISBN: 978-1119259763 
magpi.cc/2yjcB7h 


There’s a big leap 
from reimplementing 
a few classic arcade games 
in Pygame to designing and 
programming complex modern 
games. It’s certainly not something 
that would fit into one book, and 
Smed and Hakonen are concerned 
here only with the computer science 
side of game programming - in 
particular practical algorithms, and 
solving network-related problems. 
More than 70 algorithms are 
presented, covering random 
numbers, noise in data (a realistic 
world is full of imperfections), 
procedural generation, 
tournaments, game trees, path 
finding, group movement, decision 


AFTER THE 
INTERNET 


Author: Ramesh Srinivasan po TA 
& Adam Fish SS 

Publisher: Polity 

Price: £14.99 


ISBN: 978-1509506170 
magpi.cc/2ygyvrM 


What is the internet? 
A means of connecting people 
around the world, empowering 
them to better things, and 
spreading enlightenment? A way 
of monitoring citizens’ every 
activity? An echo chamber of 
sterile non-debate, and opinions 
repeated unquestioned? A means of 
monetising every click you make, 
as the so-called sharing economy 
concentrates power and wealth in 
the hands of a few platforms? 
Srinivasan and Fish tackle head 
on the gloomier prognostications 
of other commentators and 
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making, and modelling uncertainty 
— as well as networking problems, 
including dealing with cheating. 

The exercises at the end of each 

chapter range from simple 

thought exercises to studying 
Braben and Bell’s name- 
generation algorithm from 
Elite (1984). 

The gaming landscape has 
changed massively since the 
first edition was published in 
2006, in particular with the 

move to online and social 
gaming, but most of the underlying 
problems remain the same ~- so 
while exercises and examples 
change, the algorithms remain. 
You’ll need to be comfortable with 
algorithms and data structures to 
tackle the book (see The MagPi #45 
and #62 for our recommendations), 
but use of pseudocode throughout 
ensures the book works equally 
well for C, C++, Java, Python, 
or even C# programmers. 


Score 


sociologists, whilst tackling some 
of the utopic myths of the internet. 
The language is academic - and 
that of the sociologist, not the CS 
department - so if talk of post- 
structuralists, semantics, and 
semiotics is not your cup of tea, 
you may take a few pages to settle 
in. It’s worth persisting, though 
- despite clearing the grounds of 
myths, the authors discover many 
signs of hope in the contested space 
of what makes up the internet. 
Ignoring both the techno- 
utopians, and the doom-mongers, 
gives a clearer view. From grassroots 
liberation struggles to a platform 
for whistleblowers, After the 
Internet chronicles successes and 
failures in struggles for justice 
and equality, and points towards 
the internet as an assemblage of 
transformative movements. 


Score 


BOOKS 


ESSENTIAL READING: 
BEYOND FUNCTIONAL 


There's more to functional programming 
than recursive functions, immutable 
data, and homoiconicity. 


Functional Programming in R 


Author: Thomas Mailund 
Publisher: Apress 

Price: £14.99 

ISBN: 978-1484227459 
magpi.cc/2yhPN8f 


Much more than just a tool for statisticians, 
Ris surprisingly well suited to function 
composition and immutable data. 


The Little Elixir 
& OTP Guidebook 


Author: Benjamin Tan Wei Hao 
Publisher: Manning 

Price: £21.99 

ISBN: 978-1633430112 
magpi.cc/2ygXVpv 


Fault tolerance, supervision, and 
distribution - what more can we 
say? How about property-based 
and concurrency testing? 


Thinking Functionally 
with Haskell 


Author: Richard Bird 

Publisher: Cambridge University Press 
Price: £35.99 

ISBN: 978-1107452640 
magpi.cc/2ygY3Fv 


Re 
d We 
THINKING 4 


FUNCTIONALLY 
vith 
HASKELL 


A strongly mathematical way of 
looking at functional programming 
- opinionated but excellent stuff. 


Functional and Reactive 
Domain Modeling 

Author: Debasish Ghosh 
Publisher: Manning 

Price: £42 

ISBN: 978-1617292248 
magpi.cc/2ygY240 


Domain-driven design with real-world 
functional programming - Scala and Akka - 
and the resilience and elasticity of reactive 
principles. Insightful. 


Type-Driven Development 
with Idris 


Author: Edwin Brady 
Publisher: Manning 
Price: £35 

ISBN: 978-1617293023 
magpi.cc/2ygPydo 


Safer code without depending on unit 
tests? This practical book will get you to 
truly appreciate type-driven techniques. 
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INTERVIEW 


TO TOGO WITH PI 


Dominique Laloux has spent five years helping set up educational computer labs in 
the African nation of Togo. Here’s how he’s done it and how you can help 


ne of the key factors of Africa: two in small villages located Togo in preparation for a project 
the Raspberry Pi is its low in the hilly region of Kuma, the (completely unrelated to ICT), I met 
price. This enables less third one in the nearby town a small group of colleagues in the 
affluent people to getinonthe new of Kpalimé.The first one is set small village of Kuma Tokpli. 
computing revolution, whether up in the village of Kuma Tokpli, During a long, informal 
in the UK or in poorer nations like for the benefit of students and conversation, one experienced 
Togo. Brussels computer science teachers of middle and high schools French and history teacher told me: 
teacher Dominique Laloux has in surrounding villages. The two “I feel like a 21st century illiterate 
been working with and helping others are set up in secondary because I cannot use a computer.” 
the Togolese to bring computing schools. Our first lab was a rather That statement impressed me very 
education to schools and has made ‘conventional’ computer lab, set much, and I decided to challenge 
good use of the Pi in this effort. up with ‘retired’ laptop computers. him by offering to send a few 
The two others are Raspberry Pi computers along, on the condition 
Can you tell us about the computer labs: each of their 20+ that he promised me to learn how 
Renner educational work you do in Togo? workstations is a Pi. The original to use them. 
training is Since 2012, some Togolese friends lab will soon be updated to include He probably thought I was not 
Seen hea and I have set up three computer Raspberry Pis. serious about that offer, but a 
learn properly labs in rural areas in Togo, West Our efforts now tend towards two few months later I had collected, 
main objectives: to set up one new refurbished, tested, and packed 
Raspberry Pi in one middle/high enough equipment to set up a fully 
school every year, and to promote functional computer lab with 25 
the use of the Raspberry Pi as an computers, a network printer, a 
alternative to more ‘conventional’ projector, a whiteboard, etc. 
computers in schools and other I went back to Kuma a couple 
educational communities in Togo of times and, by October 2012 we 


and anywhere resources are scarce. were ready to install a small local 

construction with proper electrical 
How did the idea come about? wiring, a local area network, and 
In 2011, while I was visiting the 25 workstations. We started 
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Proper size room (7 x 11 
metres typical classroom): 
must be clean, dry, 
ventilated, well protected 
against insects/rodents 
and, of course, protected 
against intrusions. 


Electrical wiring: recent 
and well protected, 
with differentials, 
circuit breakers, cable 
ducting along the walls, 
no cables on the floor 
around workstations. 


Local area network, 
including a switch (100 Mb + 
1 Gigabit port). 


Ideally 20 or more Raspberry 
workstations, plus one for 
the teacher. 


A local server, which can 
simply be a faster laptop, 
working as a file server, a 
web server, or Kiwix. 


Accessories: network 
printer, scanners, video 
projector, etc. 


Whiteboard rather than 
chalk (to avoid dust) - a flip 
chart can be sufficient. 


ICT-related posters 
to illustrate important 
concepts/decorate. 


Avery broad collection 

of applications including 
LibreOffice, Firefox, 
Chromium, Gimp, Audacity, 
GanttProject, FreePlane, 
GnuCash, some music 
composition software, 
scanning tools, games, 
utility programs, etc. 


training teachers the week after. No 
school, no village, no community in 
the entire region had ever had such 
a ICT facility at their disposal. 

2012 is also the year the first 
Raspberry Pi was introduced and 
I was lucky to get one of the very 
first units available in Belgium. I 
immediately made the link with our 
small action in Togo. 

In 2013, I was offered a full year 
sabbatical by my employer, in order 
to be able to focus exclusively on 
what had become a not-for-profit 
project — the ‘Centre Informatique 
de Kuma’ (Kuma Computer Centre). 

During that year, it became 
obvious that it would be best to 
have a second computer lab, located 
in the nearby village of Kuma 
Adamé, in order to make it possible 
for students to benefit from an 
introduction to ICT while avoiding 
the dangers of walking the path 
between the two villages 

In summer 2014, we opened our 
second lab in Kuma Adamé - the 
first Raspberry Pi computer lab 
in Togo — for the benefit of about 
200 young students and their 
seven teachers. 


Why the Raspberry Pi? 

Three aspects of the Raspberry Pi 
make it a very serious alternative to 
more ‘conventional’ computers in 
developing countries or in any place 
where resources for education are 
scarce (including in my country!): 
low cost, low power requirements, 
low maintenance. 

One must consider an often 
forgotten aspect of computer 
donations to developing countries: 
what is initially a kind gesture 
can easily turn into a ‘poisoned 
gift’. Older, ‘retired’ computers 
are inevitably likely to break down 
after a while. In a developing 
country where resources are 
scarce, it can then be difficult and 
expensive to repair them (spare 
parts are difficult to find and often 
expensive; technical skills are not 
always available...). Such machines 
are also often relatively more 
‘power hungry’. 


De 


\bove Work 
has to go into 
making sure the 
classrooms are 
ready to be used 


What can go wrong with the 
Raspberry Pi setup? A computer 
screen going bad? An input device 
that stops working? A damaged 
SD card? None of these is really an 
expensive problem. We’ve got very 
nice second-hand 17-inch computer 
screens for about €5 a piece; nearly 
new keyboards and mice (discarded 
by companies) for less than €4 each. 

The most expensive failure? One 
of the computers that fails and 
must be replaced. That would cost 
exactly €35. In fact, we have a small 
reserve of several Raspberry Pias a 
backup: in nearly four years, we’ve 
never had to use one! 


How have students reacted to 

the classes? 

They simply love it! Most of them 
quickly take ownership of their 

ICT education. And some are eager 
to move much further than the 
simple use of ICT, dreaming about 
getting engaged in maintenance, 
programming, and other IT-related 
higher education. And, in the small 
groups I have worked with since 
2012 in Kuma Tokpli, some of them 
actually have reached a level where 
they can consider such a path for 
their higher education. 


Want to aid Dominique and his friends in their 
efforts? Head to initic.be to find out how you can 


support them with equipment, money, or your own 
personal time and labour. 
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YOUR ARCADES 


Last month we told you how to 
build an arcade machine. Here 
are some you’ve already created 


t the end of issue 63’s arcade build feature, we 

showed off some of the alternative arcades 

you could try. Unfortunately, we didn’t have 
space to show all of them, so here are some of the best 
arcade machines from around the community. 


Not content with making one arcade machine, 
Circuitbeard (Matt Brailsford) has made multiple 
amazing custom Raspberry Pi arcades. Each of them 
has had a ridiculous level of work put into it, so we’re 
going to show off three of his incredible creations here. 


= $ : © 


An old Grandstand Scramble desktop 
arcade machine was repurposed to 
make this mini Pi arcade 
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The Rombus-CT is a 
hand-built two-player 
cocktail arcade cabinet 


Playing games on it is easy, 
and Circuitbeard even 
connected a keyboard to it 
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Arcade cabinets are not just for arcade games! 
This custom Legend of Zelda build themed around 
Ocarina of Time is a beautiful thing, its style 
reminding us more of pinball table than the kind 
of arcade machines you normally see. Of course, 
you can still play arcade games on here, but you 
can also play Link to the Past. 


This arcade machine actually uses a 4:3 monitor, 
much more accurate for classic coin-op games 


Donkey Kong is one of the all-time classic arcade games, 
introducing video game superstar Mario to the world, as well as the 
titular Donkey Kong himself. This excellent build takes an old wine 


This cabinet was hand- 
barrel that looks like the kind the big gorilla chucks at you, and Matt built, the wood stained and 


has installed a control system and screen so it can be used a bit like a Rainted, andwinysgraphics 


applied to the surface 


cocktail arcade table. 


With new decals, it’s properly 
branded to the arcade classic. For 
more details on the build, see the 
project showcase in this issue 


An inspired build sees a classic kids’ toy 
repurposed as a mini Out Run cabinet. It 
uses up a lot less space than the real thing 
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BIG BIRTHDAY 
WEEKEND? 


The Raspberry Pi Foundation wants to put ona 


global celebration for its sixth birthday. “RASPBERRY 


Here’s how you can help 
á d 


or the past few years, the Raspberry Pi a 
Foundation has held a community event in 
Cambridge around Raspberry Pi’s birthday, 
where people have come together for a huge party 
with talks, workshops, and more. Now they want 
more people to have the chance to join in with the 
birthday celebrations next year, so they’re going to ~ 
be coordinating Raspberry Jams all over the world 
to take place over the Raspberry Jam Big Birthday 
Weekend, 3-4 March 2018. Already registered? Here’s 
what you need to do next. AE 


What do you need to do? 

At this point, you should be looking for a venue, and 
aiming to book the date as soon as possible. Don’t 
leave it too late, or you might have difficulty securing 
a location. If you need some advice on finding 


NEED HELP 


a venue, refer to the appropriate section in the 
Guidebook (magpi.cc/2q9DHfQ). STARTING A JAM? 
Once you’ve done that, you should create a sign-up 
page for your event (on Eventbrite, for example). 
Then you can submit your event to the Jam map 
(magpi.cc/28Nxeff), and start to publicise it locally. 
We’re planning to produce some limited-edition 
‘tour’ T-shirts for the Big Birthday Weekend and 
we’d like to include as many Jams as possible on the 
back print. To make sure your event gets included, 
submit your Jam to the map as soon as possible. 


Stay connected 

If you’re not already a member, you might find it 
useful to join the Raspberry Jam community on Slack 
(slack.com), where Jam organisers share ideas and 
help each other. Just email jam@raspberrypi.org to 
request an invitation to join. 
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THIS MONTH IN Pl 


Community 


KICKSTART THIS! 


Raspberry Pi projects you can crowdfund this month 


DUAL BATTERY HAT 


PI/104 


| kckst/2haooz | | magpi.cc/2zvpaHp | 


Portably power your Raspberry Pi with powerful 
18650 lithium-ion batteries thanks to this very 
special HAT. 18650 batteries are a fair bit larger than 
AA batteries, but can contain a lot more charge, 
which is great for when you need your Pi to stay on 
for longer. It’s already hit its goal, so now is a good 
time to jump on it. 


Something a bit more industrial: the Pi/104 is a 
Raspberry Pi Compute Module dock that allows the 

CM to conform to the PC/104 standard. The Raspberry 
Pi is popular in industrial automation setups and the 
creator project Adam Parker believes the price allows 
for prosumers to make use of it as well. Give it a look as 
there’s not many products like this around. 


BEST OF THE REST 


U at kid 


a 


ae 
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TOUCHSCREEN & 
BOOMBOX 


Retro upcycling with a Raspberry Pi 
is good fun, and we love this proper 
Eighties stereo being upgraded with 
a Raspberry Pi. Hopefully it’s portable 
so you can sling it over your shoulder 
and walk down the street with it. 
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Here are some other great things we saw this month 
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n its tenth anniversary year, PyCon UK On Thursday, 24 educators attended Picademy, 
took place at Cardiff City Hall in October, the programme from the Raspberry Pi Foundation 
bringing together professional Python coders, that supports them in digital making. Professional 
hobbyists, children, and educators. coders and hobbyists from the main conference 
The programme was varied and packed with ideas, dropped in to help with projects including a man 
with up to nine streams running at the same time. overboard alarm, a spinning pumpkin decorator, 
Among other things, there was an introduction to and a motion-activated ghoul. 
object-oriented programming, talks on artificial Django Girls ran a one-day workshop to introduce 
intelligence, and tips on getting the best performance women to programming using the Django web 
from Python. BBC micro:bit sessions showed how to framework. Student Shuping Li took part and said: 
code the device in MicroPython, and offered advice for “The best thing was that it made me feel I was able 
those teaching with it. to use Python despite having zero experience. I went 
from nothing to making a blog in a day.” 


Wheely good 

Ben Nuttall, Raspberry Pi Community Manager, revealed 
how the process for installing Python packages has been 
accelerated on the Raspberry Pi. ‘Wheels’ are Python 
packages that have been compiled for a particular 
architecture. They’re smaller files to download, and 
there’s no time spent compiling after you download 
them. The Python Package Index (PyPI) doesn’t support 
ARM packages, though, so Ben built his own repository, 
called piwheels. It involved compiling more than 96,000 
packages, and a total of over 670,000 version releases, 
using cloud-based Pis. If you’re using Raspbian Stretch, 
piwheels is already configured as an additional index. 
For installing a package like NumPy, it could save you 
over two hours of compilation time on a Raspberry Pi 1. 


Mikey Lear and Luke Spademan 
test a micro:bit-controlled robot 


Photos: Mark Hawkins, composedimages.co.uk 
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This PyCon introduced the John Pinner Awards, 


named in tribute to the late PyCon UK founder. 
Ten medals were awarded to recognise those 
who contribute to the Python community. The 
first recipients were Cat Lamin, Daniele Procida, 
Eléonore Mayola, Joshua Lowe, Leona So, Mary 
Mooney, Sheila Pinner, Tim Golden, Tony Ibbs, 
and Vincent Knight. Congratulations to them all! 


A jewel in the crown 

Saturday was children’s day, described by Daniele 
Procida, a member of the organising committee, as 
“one of the jewels in the crown of PyCon”. There was 
a Code Club, which included a session led by Joshua 
Lowe. At 13 years old, he is the creator of EduBlocks, 

a drag-and-drop interface for programming Python 
that makes it easier to transition from Scratch. At the 
same time as the Code Club, a Raspberry Jam took 
place next door. It included an introduction to physical 
computing with the Raspberry Pi, Minecraft hacking, 
and science experiments using the Sense HAT. 


The best thing was that it made 
me feel I was able to use Python 
despite having zero experience 


At the end of the day, the children presented their 
projects to the conference in a session held in the 
main assembly room. Pi projects included an LED 
caterpillar, a game using the Python turtle module, 
and a burglar alarm. The micro:bit was used to make 
a kindness badge, a calculator, and a Morse code 
transmitter. The children shared some of their coding 
experiences from the day, too. One said: “We had to 
type out things. Type in things. Type out things. Then 
it worked!” Many of the professional coders in the 
room recognised that pattern. 

On Sunday afternoon, some attendees came 
together to see how Python can be used to help 
identify people at risk of developing Alzheimer’s 
disease. The conference ended with a day of 
programming sprints, including Trans*Code, 

a hackday dedicated to tackling issues faced by 
transgender people. 

If you missed out this year, you can catch up online. 
The schedule now includes links to presentations 
and videos, where available. Find them at 
2017.pyconuk.org/schedule. 
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The first winners of 
the John Pinner Award 
collect their medals 


Joshua Lowe 
kicks off Code Club 
by introducing 
EduBlocks 


Fiona Murray and 
Miriam Winkels 
make a pumpkin 
decorator in 
Picademy 


yn‘oo'URaS MMM SNULWIN ULOS :04704d 


With over 
700 attendees, the 
assembly hall was 
often busy 
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COMMUNITY PROFILE 


Introducing Raspberry Pi Certified Educator, 
digital maker and all-round tech nerd, 


Lorraine Underwood 


ou just have to glance 

at educator Lorraine 

Underwood’s Twitter 
feed to realise she’s an avid 
digital maker. From her popular 
illuminated temperature staircase 
to her Nora the Explorer car, 
she’s forever making and sharing 
her creations. “I find Twitter a 
really positive and encouraging 
place to be. I live there!” she 
admits, going on to share that she 
tries to use her confidence with 
tech such as the Raspberry Pi to 
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“I saw someone had made a 
virtual-reality Arduino car connected by 
radio to a headset... but it was with three 
Arduinos and cost over $300. | thought to 
myself, ‘I could make that with a Pi for so 
much cheaper and | did!” 


Lorraine operates on a Babbage, 
proving that no bear is safe, even after 
the final bell of Picademy training 


encourage others who seem a little 
lost in their first steps into the 
community of makers. 


Getting started 
With a degree in Computer 
Science, you’d think Lorraine had 
all the know-how and confidence 
to be a digital maker from the 
start. But as she confesses, her 
education was 100% computer 
based, with no physical making 
aspects involved. It was only when 
she started working for Lancashire 
University that she began to 
dabble in the world of digital 
making, and then the bug bit her. 
At the university, Lorraine works 
as part of a team to help encourage 
and support primary and 
secondary teachers in bringing 
the new computing curriculum to 
their classroom. And with digital 
making projects, she’s found a 
hit for enticing dubious educators 
into the fold. “Teachers are very 
interested in physical computing 
and digital making,” she says 
when discussing the conferences 
and workshops her department 
hold for teachers based in the 
North West of the UK. “To run 
workshops that teachers were 
interested in, I had to look at what 
was out there in terms of physical 
computing and digital making.” 
Outside of the university, 
Lorraine continues to work closely 
within the field of education. She 
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teaches Computing at a girls’ 
grammar school, runs a small 
Raspberry Jam in Cumbria, and 
shares a passion for introducing 
computing and digital making 
to girls through Code Club and 
various community events. 


Full of ideas 

At home, she’s forever tinkering. 
“T just love to make things! I make 
a lot of things; some may call me 
prolific! I just get a cool idea in my 
head and go with it.” 


N 


“A few people have tweeted their 
version of my light-up temperature- 
controlled stairs and that just blows my 
mind. | love that I've inspired people to 
try and make things” 


Alongside the rainbow stairs, 
Lorraine is also proud of her 
virtual-reality car, a project 
that she went on to showcase 
at Newcastle Maker Faire. 
Controlled by a Nintendo Wii 
Remote, and connected by 
radio to a VR headset, it stands 
as a testament to her love of 
tinkering and working on ideas 


I just love to make things! 
I make a lot of things; 
some may call me prolific! 


Lorraine will be well known by 
many members of the Raspberry 
Pi community for making her Pi- 
powered, temperature-controlled 
stair lights — featured in The MagPi 
issue #58. With NeoPixels running 
along the bottom of her bannister, 
they change their colour from red 
to blue (with a rainbow of colours 
in between) depending on the 
outdoor temperature. The build 
was documented on her website 
and she’s found the response to 
be incredible, especially when 
people share their own versions 
of the project. 
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from pre-existing projects to 
add her own twist, this time 
replacing three Arduinos with 
one Raspberry Pi. 

In her own words, Lorraine 
explains of her tutorials, builds, 
and blog: “I try to keep everything 
cheap and accessible for your 
normal person ~ I try not to 
solder things or do complicated 
coding. I think a lot of projects 
are amazing but are really 
complicated and out of reach 
for your average person. I try to 
make my builds simple and easy 
to follow.” 


$ us | 
| 
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COMPUTING IN EDUCATION 

Lorraine spreads her experience and excitement 
across many sectors of the educational scope. As 
Computing at School coordinator for Lancashire 
University, she supports both primary and secondary 
educators in delivering the new computing 
curriculum to the classroom. She runs training, 
conferences, and events throughout the North 
West, using her interest in digital making to support 
and enthuse teachers, enabling them to take 

back interesting projects to their students. She 

also teaches at Lancaster Girls’ Grammar School, 
ensuring that she practises what she preaches. 
During Thursday Lunch, she runs a Code Club for 
students aged 11-14, and also dedicates some of 
her time to running Kendal Raspberry Jam once 

a month in Cumbria. “We're a small but growing 
Jam of mostly children and their parents,” she 
explains. “Our jammers like to play with stop-motion 
animation, Minecraft, and Scratch.” 
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EVENT CALENDAR 


Find out what community-organised, Raspberry 
Pi-themed events are happening near you... 


Want a Raspberry Jam in 
your area? Want to start one? 
Email Ben Nuttall about it: 
ben@raspberrypi.org 


BOGNOR REGIS NUNEATON RASPBERRY JAM 
RASPBERRY JAM When: Saturday 16 December 
When: Saturday 9 December Where: Nuneaton Library, 
Where: University of Chichester, Nuneaton, UK 

Bognor Regis, UK magpi.cc/2iWXWsh 
magpi.cc/2iWjjcU Mod Minecraft Pi with some 
This first Bognor Jam is primarily a Christmas-themed Python 
show-and-tell event where people coding. Make your Minecraft 
bring projects for visitors to try out. world truly festive! 
VALPARAÍSO COFFEE, CAKE AND CODING 
RASPBERRY JAM When: Thursday 7 December 


When: Thursday 14 December 

Where: General Cruz #222, 
Valparaíso, Chile 

magpi.cc/2iXM60i 

A Jam in a Chilean FabLab. There’s 

no schedule of events yet, but keep 

an eye on the website for more. 


Where: King Edward VI Sheldon 
Heath Academy, 
Sheldon, UK 
magpi.cc/2zMcJh6 
Learn good coding practice ina 
relaxed and informal setting while 
enjoying coffee and cake. 
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VALPARAISO 
RASPBERRY JAM 


REGULAR EVENTS 


CORNWALL TECH JAM 
When: Saturday 9 December 
Where: Bodmin Library, 
Bodmin, UK 
cornwalltechjam.uk 
For anyone interested in 
technology, any age or ability. 
Learn about coding in Scratch, 
Python, Minecraft, and more. 


POTTON MINCE PI & PINTS 
When: Saturday 9 December 
Where: The Rising Sun, 

Potton, UK 
magpi.cc/2zJwdmB 
A Christmas-themed Pi & Pints 
event, where you have fun 
with Raspberry Pi in a relaxed, 
social atmosphere. 
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WE'VE HIGHLIGHTED SOME OF 
THE AREAS IN NEED OF A JAM! 
CAN YOU HELP OUT? 
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8, TORBAY TECH JAM 


PI TOWERS RASPBERRY JAM 

When: Saturday 9 December 

Where: Raspberry Pi Foundation, 
Cambridge, UK 

magpi.cc/2zKYo4L 

A family-friendly event where 


everyone is welcome. Coding “We use the Eventbrite app to check in attendees i @ T A Æ 
and digital making activities will where possible. However, people tend to arrive a Q & 
be provided. all at once and we don't like a queue. If it's not x ye VA ` 
possible to scan the tickets, we just check them > ù N / a ’ 

TORBAY TECH JAM as they come in. It means our numbers are a little & Q 
When: Saturday 9 December off, but it keeps people happier.” PAW 
Where: Paignton Library, Michael Horne hd 

Paignton, UK CamJam hm ¢ 
torbaytechjam.org.uk @ a 
This Jam is designed to be Every Raspberry Jam is entitled to apply for a Jam ain Bade < 


a fun, informal, and family- 
friendly event, for all ages 
and experience levels. 


starter kit, which includes magazine issues, printed eaa 


worksheets, stickers, flyers, and more. Get the book 
here: magpi.cc/2q9DHfQ. 
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LETTERS 


Monitors of green 

Whenever I see pictures get posted from official 
Raspberry Pi events like a Picademy or something 
similar, I always see these wonderfully vibrant 
bright green monitors that are used. Where do 
those monitors come from? Are they some kind of 


official Raspberry Pi monitor? I’d love to get one! 
Frank Reid 


pe-topDASHADARD 


CEEDuniverse 


y 
5 | FA 


They are very iconic monitors, aren’t they? They’re 
not official Raspberry Pi products; in fact, they’re 
actually pi-topCEEDs. These are the cut-down 
desktop version of the pi-top laptop. They just 
include a screen, but you can still plug a Raspberry 
Pi into it — all you then need to add is a mouse 

and keyboard. They are also readily available for 
purchase; check out more details on them here: 
magpi.cc/2zaTkWj. 


The CEED is used by the education 
and community team at the Raspberry Pi 
Foundation in many of their events 


Missing files 

I have a problem downloading the 
file scratch_gpio_handler.py 
from issue 10 of The MagPi. In 

the article ‘Scratch Controlling 
GPIO 2 - Birthday Pi’, there is a 
link you need to download files 
from using wget, but it doesn’t 
work. Perhaps you can help me? 
Max 


Some of the content in older 
issues of The MagPi points towards 
an old MagPi website that no 
longer exists; sorry about that. 
However, the code from the first 
30 issues of the magazine (and 
the majority of the other issues) 
can be found in our GitHub repo: 
github.com/themagpimag. 

In this instance, the correct 
files can be found here: 
magpi.cc/2jaiYU5. 

For cases like this, you just need 
to download the files manually 
from our GitHub repo, then proceed 
to the next step in the tutorial. 


94 | MägPi December 2017 


raspberrypi.org/magpi 


O3 ez Da 8-5 Re DG 
FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of conversations 
and problem-solving for the community - join in via 
raspberrypi.org/forums 


t You can 
now get your 
ZeroBot STLs 
from a new place 


n one of the 
more recent 
MagPi 
Essentials books 
about GPIO Zero, 
there is a reference 
to ZeroBot that was first 
presented in issue 40 of The MagPi. 
As I seem to have all the stuff needed to The sim ple way to mount your Pi! 
build a ZeroBot, I thought I’d do it. However, 
the link to the thing on Thingiverse is broken. 
The thing seems to have been taken down. So I - Industrial DIN rail mount 
can’t print the chassis... s 
Does anyone know where I can find the STLs © Open frame for better airflow 
nowadays? Or is there anyone who can supply A Integ rated USB strain relief 
them for me? 
Thanks in advance! 
Jonas Lorander 


You’re not the first person to ask us about this 
recently, so we thought we’d make a note of 

it here — the files for the original 3D-printed 
chassis that Richard Hayler found for that 
tutorial have mysteriously vanished from the 
internet. We did locate an alternative upload, 
but that too has gone. 

Since then, someone has been kind enough to 
upload the files to Thingiverse, and even called it 
ZeroBot for easy Google searching! You can find 
it at the link here: magpi.cc/2zWomzb. 

Unfortunately, the internet is forever 
changing and not all of it is archived properly, 
so things like this may disappear. If you ever find 
a link that no longer works, please let us know 
via email at magpi@raspberrypi.com or on the 
forum and we’ll try to help out. 
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f 
START A CODE CLUB 
IN YOUR SCHOOL! 


Code Club is a network of volunteers and educators who 
run free coding clubs for young people aged 9-13. 


Our aim is to inspire the next generation to 
get excited about computer science and digital making. 


"We use Code Club's fun educational resources to run a 
weekly after-school club for Year 7 and Year 8 pupils. The 
| | students benefit considerably from the extra challenge!” 


Karen Dadd, Computing Teacher 


KA Code Club is free 


KA Code Club provides step-by-step guides for 
Scratch, Python, HTML, and Sonic Pi 


[A Code Club helps children develop skills including 
logical thinking, creativity, and resilience 


We have over 6000 clubs across the UK teaching 
more than 80,000 young people to code—come and join us!" 


Find out more at www.codeclub.org.uk 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 G5 


NF 


In association with 


piborg.org 


MONSTERBORG 
& THUNDERBORGS 


A beast of a kit designed to be taken off road or driven 
autonomously. It’s also the primary racing robot for Formula Pi. 


One lucky winner 
will own this robot 


The MonsterBorg can be 
programmed as a self-driving 
robot, used for education about 
self-driving systems, or raced 
around the garden as an RC 
off-roader. It also makes a great 


platform for hacking about with A >A a She va daN 
robots by adding extra sensors id a 5 as = COA. i eee pees E 
or servos (magpi.cc/2ltc8gT). 5 Amps reg v a 


gual output 


For a chance to win a MonsterBorg 
or one of three ThunderBorgs, you 


just need to go online and enter Dual 5A Motor Controller 
our competition. with DC/DC & RGB LED 
Terms & Conditions 


Competition opens on 29 November and closes on 28 December 2017. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry 
Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the 
competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The 
MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no 


cash alternative will be offered. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Column THE FINAL WORD 


digital making to educators 


aspberry Pi computers are meant to get young 
people to understand how computers work 
and to empower them with the ability to make 
things with computers. In order to do that, we make 
Raspberry Pi devices ultra-affordable and we offer 

a library of free project-based resources for getting 
started with them. But as you might already know, 

we don’t stop there. 

In 2017 alone, the Raspberry Pi Foundation has trained 
over 550 educators in digital making with Raspberry 
Pi computers at ‘Picademy’ workshops across the 
United Kingdom and the United States. These two-day, 
hands-on workshops are free for educators. On the first 
day, they learn about digital making, computer science, 
electronic circuits, and physical computing. They get the 
opportunity to try Raspberry Pi computers with Scratch, 
Python, LEDs, buttons, switches, the Camera Module, 
motors, and more. 

On the second day, the educators are challenged to 
collaborate in groups to create a project with tools and 
concepts that they learned the day before. They are 
then sent home with a kit of materials so that they 
can take Raspberry Pi and digital making back into 
their learning environment right away. 

I want to take this opportunity to point out that 
these learning environments aren’t only classrooms. 
It’s important to us that we take a broad view of what 
‘educator’ means. Picademy is not just for classroom 
teachers: it also includes librarians, museum 
educators, after-school program leaders, scout 
leaders, and makerspace educators. There are many 
opportunities for young people to learn inside and 
outside of the classroom and we want to make sure 
we’re supporting all possible pathways to learning. 

For our charity, training educators is a great way 
to have the biggest possible impact on young people 
around world. Educators know what works best for 
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MATT RICHARDSON 


Matt Richardson is the Executive Director of the Raspberry 
Pi Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


EMPOWERING 
EDUCATORS 


7 Matt Richardson shares his thoughts on bringing 


those in their teaching environment. They have 

the experience to reach youngsters and get them 

to understand the concepts behind digital making. 
When we show these educators the power of digital 
making and Raspberry Pi, they can take these lessons 
and apply them the way that they see fit for the kids 
that they work with. And purely from a numbers 
perspective, if every educator we train goes on to 
teach only ten young people on average, then our 
impact is already increased by an order of magnitude. 

The Picademy experience doesn’t end with the 
workshop. Those who attend become Raspberry Pi 
Certified Educators and join a passionate community 
of digital making enthusiasts. They stay in touch, 
collaborate, share best practices, organise Raspberry 
Jams, run Code Clubs, and train other educators 
back home. 

I acknowledge that not every educator has the means 
to travel to our workshops and spend two full days 
with us. For those who aren’t able to join us in person, 
we have a series of online courses on the FutureLearn 
platform. While these courses are geared towards 
educators, anyone can join them for free. They cover 
subjects such as physical computing, object-oriented 
programming, and teaching programming to children 
in primary school. You can join these courses here: 
magpi.cc/2h5Sthf. 

Even if you’re not an educator, you can still be 
involved in our educator training efforts. Every time 
you buy a Raspberry Pi or if you’ve subscribed to 

The MagPi, you’ re supporting our objective to train 
educators who will go on to have a massive impact on 
young people. And if you’re looking for other ways 

of supporting, you can help get the word out! If you 
know an educator in your community who would be 
perfect for our training, please send them our way: 
raspberrypi.org/training. 
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Available in Europe 
through RS Components 


$89” £609” 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanaKit is a registered 
trademark of Cana Kit Corporation. 
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